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OLD SCHOOL 

R etro gaming has never been as popular as it is 
today. We have an enduring affection for classic 
games that goes beyond the hit of nostalgia. There’s 
a vibrant indie development scene based on making 
modern video games in a style of 8- and 16-bit classics. 

The gaming scene of the 1980s was a vibrant, creative, 
and fascinating period. Games were made by small 
teams and even individuals. Projects were personal 
and inspiration was taken from the mundane to the 
fantastical. It was a far cry from the millions of dollars and 
massive production teams of today’s mega-hits. 

This book enables you to build a classic retro-games 
console using an incredible low-cost British computer 
called Raspberry Pi. These computers cost from just $35. 

We’ll show you how to set up the retro gaming operating 
system, attach a controller, and wirelessly add games to 
your console. Then kick back and enjoy classic games. 

And by studying the classics, you can learn to make your 
own games. We’ll show you how to code retro hits using a 
simple computer language called Python. 

Build your gaming system; play classic games; learn to 
code. What an incredible skill. What an amazing thing to 
do! We hope you enjoy this retro gaming experience. 


Lucy Hattersley 
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SET UP 

YOUR SYSTEM 


EVERYTHING YOU NEED 
TO GET UP AND RUNNING 



08 RASPBERRY PI 

QUICKSTART GUIDE 

• Gather all the equipment required 

• Set up your Raspberry Pi hardware 

• Prepare your microSD card 


14 SET UP A RASPBERRY PI 
RETRO GAMES CONSOLE 

• Discover classic gaming 
on Raspberry Pi 

• Install the Lakka 
operating system 

• Configure your game controller 


□ Turning □ Raspberry Pi 
device into □ retro games 
console is a fun project □ 
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Raspberry Pi 

QuickStart Guide 


Setting up Raspberry Pi is pretty straightforward, 
Just follow the advice of Rosie Hattersley 



C ongratulations on becoming a Raspberry 
Pi explorer. We’re sure you’ll enjoy 
discovering a whole new world of computing 
and the chance to handcraft your own games, 
control your own robots and machines, and share 
your experiences with other Raspberry Pi fanatics. 

Getting started won’t take long: just corral all the 
bits and bobs on our checklist, plus perhaps a funky 
case. Useful extras include some headphones or 
speakers if you’re keen on using Raspberry Pi as a 
media centre or gaming machine. 

To get set up, simply format your microSD card, 
download NOOBS, and run the Raspbian installer. 
This guide will lead through each step. You’ll find 
the Raspbian OS, including coding programs and 
office software, all available to use. After that, 
the world of digital making with Raspberry Pi 
awaits you. 


What you need 

All the bits and bobs you need 
to set up a Raspberry Pi computer 


A Raspberry Pi 

Whether you choose a Raspberry Pi 4 , 3 B+, 3 B, 

Pi Zero, Zero W, or Zero WH (or an older model 
of Raspberry Pi), basic setup is the same. All 
Raspberry Pi computers run from a microSD card, 
use a USB power supply, and feature the same 
operating systems, programs, and games. 
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8GB microSD card 

You’ll need a microSD card with a capacity of 
8 GB or greater. Your Raspberry Pi uses it to store 
games, programs, and photo files and boots from 
your operating system, which runs from it. You’ll 
also need a microSD card reader to connect the 
card to a PC, Mac, or Linux computer. 


Mac or PC computer 



You’ll need a Windows or Linux PC, or an Apple 
Mac computer to format the microSD card and 
download the initial setup software for your 
Raspberry Pi. It doesn’t matter 
what operating system 
this computer runs, 
because it’s just 
for copying the 
files across. 


USB keyboard 

Like any computer, you need a means to enter web 
addresses, type commands, and otherwise control 
Raspberry Pi. You can use a Bluetooth keyboard, 
but the initial setup process is much easier with 
a wired keyboard. Raspberry Pi sells an official 
Keyboard and Hub (magpi.cc/keyboard). 




USB mouse 

A tethered mouse that physically attaches to your 
Raspberry Pi via a USB port is simplest and, unlike a 
Bluetooth version, is less likely to get lost just when 
you need it. Like the keyboard, we think it’s best to 
perform the setup with a wired mouse. Raspberry Pi 
sells an Official Mouse (magpi.cc/mouse). 


Power supply 

Raspberry Pi uses the same type 
of USB power connection as your 
average smartphone. So you can 
recycle an old USB to micro USB cable 
(or USB Type-C for Raspberry Pi 4 ) 
and a smartphone power supply. 
Raspberry Pi also sells official power 
supplies (magpi.cc/products), which 
provide a reliable source of power. 





Display and HDMI cable 

A standard PC monitor is ideal, as 
the screen will be large enough 
to read comfortably. It needs 
to have an HDMI connection, 
as that’s what’s fitted on your 
Raspberry Pi board. Raspberry 
Pi 3 B+ and 3 A+ both use regular 
HDMI cables. Raspberry Pi 4 can 
power two HDMI displays, but 
requires a less common micro- 
HDMI to HDMI cable (or adapter); 
Raspberry Pi Zero W needs a mini HDMI to 
HDMI cable (or adapter). 


USB hub 

Instead of standard-size USB 
ports, Raspberry Pi Zero has 
a micro USB port (and usually 
comes with a micro USB to USB 
adapter). To attach a keyboard 
and mouse (and other items) to a 
Raspberry Pi Zero W or 3 A+, you 
should get a four-port USB hub 
(or use a keyboard with a hub 
built in). 
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Setup 

Raspberry Pi 

Raspberry Pi 4 / 3B+ / 3 has plenty of 
connections, making it easy to set up 


Connect a mouse 

Connect a USB wired mouse to one of the 
other larger USB A sockets on Raspberry Pi. As 
with the keyboard, it is possible to use a Bluetooth 
wireless mouse, but setup is much easier with a 
wired connection. 


01 

Hook up the keyboard 

Connect a regular wired PC (or Mac) 


03 


keyboard to one of the four larger USB A sockets on 
a Raspberry Pi 4 / 3B+/ 3. It doesn’t matter which 
USB A socket you connect it to. It is possible to 
connect a Bluetooth keyboard, but it’s much better 
to use a wired keyboard to start with. 


HDMI cable 

Next, connect Raspberry Pi to your display 
using an HDMI cable. This will connect to one 
of the micro-HDMI sockets on the side of a 
Raspberry Pi 4, or full-size HDMI socket on a 
Raspberry Pi 3/3B+. Connect the other end of the 
HDMI cable to an HDMI monitor or television. 



A HDMI cable, such as ones used by most 
modern televisions, is used to connect 
Raspberry Pi to a TV or display. You’ll need a 
micro-HDMI to HDMI cable (or two) to set up 
a Raspberry Pi 4. Or a regular HDMI cable for 
Raspberry Pi 3B+ / 3 (or older) models. 


A regular wired mouse is connected 
to any of the USB A sockets. A wired 
keyboard is connected to another 
of the USB A sockets. If you have a 
Raspberry Pi 4 , it’s best to keep the 
faster (blue) USB 3.0 sockets free for 
flash drives or other components. 
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Setup 

Raspberry 
Pi Zero 

You'll need □ couple of adapters to 
set up a Raspberry Pi Zero / W / WH 


Get it connected 

If you’re setting up a smaller Raspberry 
Pi Zero, you’ll need to use a micro USB to USB A 
adapter cable to connect the keyboard to the 
smaller connection on a Raspberry Pi Zero W. The 
latter model has only a single micro USB port for 
connecting devices, which makes connecting both 
a mouse and keyboard slightly trickier than when 
using a larger Raspberry Pi. 


You'Ll need this micro USB 
to USB A adapter to connect 
wired USB devices such as a 
mouse and keyboard to your 
Raspberry Pi Zero W 



Raspberry Pi Zero W features a 
mini-HDMI socket. You'Ll need 
a mini-HDMI to full-sized HDMI 
adapter Like this to connect 
your Raspberry Pi Zero W to an 
HDMI display 


Mouse and keyboard 

You can either connect your mouse to a 
USB socket on your keyboard (if one is available), 
then connect the keyboard to the micro USB 
socket (via the micro USB to USB A adapter). 

Or, you can attach a USB hub to the micro USB 
to USB A adapter. 


More connections 

Now connect your full-sized HDMI cable 
to the mini-HDMI to HDMI adapter, and plug the 
adapter into the mini-HDMI port in the middle of 
your Raspberry Pi Zero W. Connect the other end of 
the HDMI cable to an HDMI monitor or television. 
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You'll Need 

> A Windows/Linux 
PC or Apple Mac 
computer 

> A microSD card 
(8GB or Larger) 

> A microSD to 
USB adapter (or 
a microSD to 
SD adapter and 
SD card slot on 
your computer) 

> SD Memory Card 
Formatter 

rpf.io/sdcard 

> NOOBS 

rpf.io/downloads 


Setup 

the software 

Use NOOBS to install Raspbian OS 
on your microSD card and start your 
Raspberry Pi 

N ow you’ve got all the pieces together, it’s 
time to install an operating system on your 
Raspberry Pi, so you can start using it. 

Raspbian is the official OS for Raspberry 
Pi, and the easiest way to set up Raspbian on 
your Raspberry Pi is to use NOOBS (New Out Of 
Box Software). 

If you bought a NOOBS pre-installed 16GB 
microSD card (magpi.cc/huLdtN), you can skip 
Steps 1 to 3. Otherwise, you’ll need to format a 
microSD card and copy the NOOBS software to it. 



Format the microSD 

Choose the Quick Format option, then click 
Format (if using a Mac, you’ll need to enter your 
admin password). When the card has completed 
the formatting process, it’s ready for use in your 
Raspberry Pi. Leave the card in your computer 
for now and note its location: Windows will often 
assign it a hard drive letter, such as E; on a Mac it 
will appear in the Devices part of a Finder window. 



Prepare to format 

Start by downloading SD Card Formatter 
tool from the SD Card Association website 
(rpf.io/sdcard). Now attach the microSD card 
to your PC or Mac computer and launch SD Card 
Formatter (click Yes to allow Windows to run it). 

If the card isn’t automatically recognised, remove 
and reattach it and click Refresh. The card should 
be selected automatically (or choose the right one 
from the list). 



Download NOOBS 

Download the NOOBS software from 
rpf.io/downloads. NOOBS (New Out Of Box 
System) provides a choice of Raspberry Pi 
operating systems and installs them for you. Click 
‘Download zip’ and save the file to your Downloads 
folder. When the zip file download is complete, 
double-click to launch and uncompress the folder. 
You’ll need to copy all the files from the NOOBS 
folder to your SD card. Press CTRL+A (§€+A on a 
Mac) to select all the files, then drag all the files 
to the SD card folder. Once they’ve copied across, 
eject your SD card. Be careful to copy the files inside 
the NOOBS folder to the microSD card (not the 
NOOBS folder itself). 
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Assemble your Raspberry Pi 

Now it’s time to physically set up your 
Raspberry Pi. Plug your PC monitor into the mains 
and attach its HDMI cable to the corresponding 
HDMI port on your Raspberry Pi. Plug in the power 
supply but don't attach it to Raspberry Pi just yet. 
Use two USB ports to attach keyboard and mouse. 
Finally, remove the microSD card from the SD 
card adapter and slot it into the underside of your 
Raspberry Pi 4, 3B+, or 3. Raspberry Pi Zero W 
owners will need to attach a USB hub to connect 
mouse, keyboard, and monitor; the microSD card 
slot is on the top of its circuit board. 


Power up 

Plug in your Raspberry Pi power supply 
and, after a few seconds, the screen should come 
on. When the NOOBS installer appears, you’ll 
see a choice of operating systems. If you want 
to skip the default operating system and build 
a retro games system, move ahead to Step 4 on 
page 15. But to see what Raspberry Pi can do as a 
computer, tick Raspbian and click Install, then 
click Yes to confirm. Installation takes its time but 
will complete - eventually. After this, a message 
confirming the success installation appears. Your 
Raspberry Pi will prompt you to click OK, after 
which it will reboot and load the Raspbian OS. 


Get online 

When Raspbian loads for the first time, 
you need to set a few preferences. Click Next, 
when prompted, then select your time zone and 
preferred language and create a login password. 
You’re now ready to get online. Choose your WiFi 
network and type any required password. Once 
connected, click Next to allow Raspbian to check 
for any OS updates. When it’s done so, it may ask 
to reboot so the updates can be applied. 

Click the Raspberry icon at the top-left of the 
screen to access items such as programming IDEs, 
a web browser, media player, image viewer, games, 
and accessories such as a calculator, file manager, 
and text editor. You’re all set to start enjoying your 
very own Raspberry Pi. M 
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Set up a Raspberry Pi 

retro games console 



Lucy 

Hattersley 


Lucy is editor of The 
MagPi magazine. 

She enjoys retro 
gaming; especially 
making retro games. 

magpi.cc 


You'll Need 


> Raspberry Pi 4 

> USB or wireless 
game controller, 

e g. magpi.cc/ 
vilrosgamepad 

> Windows PC or 
Mac computer 
for setup 

> Blank microSD card 
( 8 GB or larger) 

> SD Formatter 

magpi.cc/ 

sdcardformatter 

> NOOBS image file 

magpi.cc/downloads 

> A game ROM, e.g. 

magpi.cc/bladebuster 


Lakka lets you relive the games of the past by enabling your 
Raspberry Pi to emulate a host of retro computers and consoles 


W hether you are nostalgic for the games 
of yesteryear or you’re simply dying 
to discover gaming’s rich history, all 
you ultimately need to get stuck in is a bunch of 
emulators and a stack of gaming ROMs. 

In the past, however, this has also entailed 
finding and downloading the BIOSes of various 
machines and a fair bit of configuration. 
Fortunately, with the software platform Lakka 
installed on your Raspberry Pi 4, the path to 
gaming glory is much smoother these days. 

Lakka allows you to emulate arcade games as 
well as titles originally released on a host of 8-bit, 
16-bit, and even 32- and 64-bit systems. 

Lakka is a Linux operating system (OS) based 
on RetroArch (retroarch.com). Lakka is designed 
to run games, and it turns a Raspberry Pi into a 
powerful games system. 

You can hook up a gamepad and even make use 
of wireless controllers (there’s more about those 
at magpi.cc/HpPSSV). It has an interface that will 
be very familiar to anyone who has used modern 
games consoles and because it is open-source, it 
is constantly being improved. 

You can run Lakka on any Raspberry Pi, 
although Raspberry Pi 4 enables smoother 
emulation of more recent consoles. 



▲ NOOBS (New Out Of Box Software) is used to install 
operating systems such as Lakka on Raspberry Pi 


Some features help you organise your growing 
gaming collection and take screenshots of the 
in-game action. For now, though, we’re looking 
solely at getting you up and running with a classic 
homebrew video game. 


Get SD Card Formatter 

We’re going to install Lakka RPI4 to a 
blank microSD card using the OS installer NOOBS 

(magpi.cc/noobs). 

In this tutorial, we’re using a Windows PC 
to format a microSD card and copy the NOOBS 
files to the card (the process is identical for Mac 
computers). We will then use the NOOBS card 
with our Raspberry Pi 4 and set up Lakka. From 
then on, our Raspberry Pi 4 will boot straight to 
Lakka and let us run games. 

First, download SD Formatter on a computer from 
magpi.cc/sdcardformatter. Click ( For Windows’ or 
( For Mac’ depending on your machine. 


Format the card 

We’re now going to format the microSD card 
that you will use to boot Lakka on a Raspberry Pi. 
Note that this completely wipes the card, so make 
sure it contains nothing you need. 

Insert the microSD card into your Windows 
or Mac computer. You will need to use either 
a USB SD card adapter or microSD card to SD 
card adapter. 

Close any alert windows that appear, and open 
the SD Card Formatter app. Accept the terms and 
conditions and launch the program. On a Windows 
PC, click Yes to ( Do you want to allow this app to 
make changes to your device’ (you won’t see this 
on a Mac; the approval comes later). 
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Main Menu 


o-0 


Cores are the emulators 
used to run retro games. 
They are modular 
components based on 
classic systems and games 


© 

x 

0 

© 
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Load Core 

Select which core to use. 


Load Content 
Online Updater 
Information 
Restart Retro Arch 
Reboot 
Shutdown 


The Settings menu has options 
to connect to a wireless 
network, turn on Samba file 
sharing, and set up a gamepad 


The card should be assigned a letter under Select 
Card. It is ( D’ on our system. Check the Capacity 
and other details to ensure you have the correct 
card. Now click Format and Yes. On a Mac, you’ll be 
asked to enter your Admin password. 


Download NOOBS 

Now visit magpi.cc/downloads and click the 
NOOBS icon. Select ‘Download ZIP’ next to NOOBS. 

The latest version of the NOOBS zip file 
(currently NOOBS_v3_2_1.zip) will be saved to 
your Downloads folder. 

Extract the files from the NOOBS zip file (right- 
click and choose Extract All and Extract). Now 
open the extracted NOOBS folder (it’s important 
to ensure you are using the extracted files and not 
looking at the files inside the zip file. Make sure 
you have opened the NOOBS_v3_2_i folder and 
not the NOOBS_v3_2_1.zip file. 

You should see three folders - defaults, os, and 
overlays - followed by many files beginning with 
( bcm2708...’. It is these folders or files you need to 
copy to the microSD card. 

Select all of the files inside the NOOBS folder 
and copy them to the microSD card. When the files 
have copied, eject and remove the microSD card 
from your PC or Mac. 


Boot to NOOBS 

Now set up your Raspberry Pi 4. You’ll 
need to connect a USB keyboard and HDMI display 
for the installation process (you can remove the 
keyboard later and use just a game controller). 

The display does not have to be the television 
you intend to use. It’s best to use the HDMI 0 
port. We’re going to use a wireless LAN network 
to connect to the internet, but you can connect 
an Ethernet cable attached directly to your 
modem/router. 

Insert the microSD card into your Raspberry Pi 
and attach the USB 3.0 power supply to power up. 


□ To get further installation options on 
the NOOBS screen, you will need to be 
connected to the internet □ 


Connect to wireless LAN 

The NOOBS screen will appear, displaying 
two installation options: Raspbian Full and 
LibreELEC. To get further installation options, you 
will need to be connected to the internet. 

Connect Raspberry Pi directly to your modem/ 
router using an Ethernet cable; or click the ( Wifi 
networks (w)’ icon. The WiFi network selection 
window appears; wait until it displays the local 
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▲ Blade Buster, a 
homebrew shoot- 
'em-up, running on a 
Raspberry Pi 4 



Warning! 


It is illegal to download 
copyrighted game ROMs 
from the internet. Please 
respect the original maker 
and seek a legal source 
for retro gaming instead. 
We use homebrew ROMs 
made by modern makers 
for classic systems. 


networks. Select your wireless network and enter 
the password for it in the Password field. Then 
click OK. 

With Raspberry Pi connected to a network, you 
get a much broader range of installation options. 
Near the bottom will be Lakka_RPi4. 

Use the arrow keys on your keyboard to select 
Lakka and press the SPACE bar to add a cross to its 
selection box (or use a connected mouse to select 
the Lakka option). 

Click Install and answer Yes to the Confirm 
window. NOOBS will download and extract the 
Lakka file system to the microSD card. Sit back and 
wait for the system to be installed. 

When it has finished, NOOBS will display ‘OS(es) 
Installed Successfully’. Press ENTER on the 
keyboard (or click OK with the mouse). 


Connect to the network 

You need to connect Lakka to the network. 
Use your cursor keys to navigate Lakka’s menus, 
and head to the Settings list. Press the down 
arrow and select ‘Wi-Fi’. Wait for Lakka to scan 
the local networks. 

Select your wireless LAN network and use the 
keyboard to enter the Passphrase. The Lakka 
interface will display the name of your wireless 
network with ‘Online’ next to it. 


Get a game 

Now it’s time to find and play a game. 
Games are downloaded as ROM files and added to 
Lakka. These ROM files need a compatible core to 
run (most but not all ROM files will run correctly). 

We’ 11 use a Japanese homebrew ROM called 
Blade Buster. Download it on your PC or Mac from 
magpi.cc/bladebuster - click the ‘Blade Buster 
Download’ link. 

A file called BB_20120301.zip will appear in 
your Downloads folder. Unlike NOOBS, you do not 
extract the contents of this file - ROMs are run as 
compressed zip files. 

You now need to transfer this file from your 
computer to your Raspberry Pi. 


□ Games are downloaded 
as ROM files and added 
to Lakka □ 


magpi.cc/legalroms 


Top Tip 


SSH 


You can also 
use SSH to copy 
files from your 
computer to 
Raspberry Pi. In 
Lakka, enable SSH 
in Services. You 
can use a program 
such as FileZilla to 
copy files across. 
See magpi.cc/ssh 
for more 
information. 
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Starting Lakka 

Raspberry Pi will restart and this time it will 
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boot into the Lakka operating system. You will see 
a blue screen with a series of windows and ‘Load 
Core’ will be highlighted. You can use the arrow 
keys on the keyboard to navigate the menu, and X 
to select a menu option, then Z to back up. 

Highlight Load Core and press X to select it. Here 
you will find a list of ‘cores’. These are the engines 
that emulate different retro consoles and computers. 

To test the system is working, highlight 2048 and 
press X again. You’ll be returned to the main menu, 
but this time you’ll see ‘Start Core’. Press X to start 
the core and you’ll be presented with a classic game 
called 2048. Use the arrow keys to slide the blocks 
together. Matching numbers double in size, and 
the aim is to make a 2048 block. Press ESC and ESC 
again to return to the main Lakka menu. 


Turn on Samba 

With your Raspberry Pi and PC on the same 
network, go to the Settings menu in Lakka on your 
Raspberry Pi and select Services. Highlight Samba 
and turn it on by pressing X (or using right arrow). 

Samba is installed by default on macOS and used 
to be installed by default in Windows, but it has 
recently become an optional installation. 

In Windows 10, click on the Search bar and 
type ‘Control Panel’. Click on Control Panel in 
the search results. Now click ‘Programs’ and 
‘Turn Windows features on or off’. Scroll down 
to find ‘SMB 1.0/CIFS File Sharing Support’ and 
click the ‘+’ expand icon to reveal its options. 
Place a check in the box marked ‘SMB 1.0/CIFS 
Client’. Click OK. This will enable Samba client 
support on your Windows 10 PC so it can access 
Raspberry Pi. 


16 | magpi.cc | Set up a Raspberry Pi retro games console 




















TUTORIAL 


► While you can use a 

keyboard, a proper controller 
is best for playing games 


Top Tip 


Transfer the ROM 

Lakka may appear in the 
left-hand column of your other 
computer’s file browser (File 
Explorer on a PC or Finder on a Mac). 

If not, select Lakka’s main menu on your 
Raspberry Pi, then choose Information and 
Network Information. 

Take note of the IP address. Enter that into the 
File Explorer using the format: 

\\insert.full.ip.address\ 


Ours, for example, is: 

\\ 192 .i 68 .o. 13 \ 

Copy the Blade Buster zipped game to the ROMS 
folder on Lakka. 

Back on your Raspberry Pi, go to Load Content 
> Start Directory in the Lakka menu and find the 
BB_20120301.zip file. Click it before selecting 
Load Archive. Choose FCEUmm as the core to 
play it on. 

Press ENTER to start the game. Use the arrow keys 
to move and X to fire. Enjoy playing the game. Press 
ESC twice when you’re done, to return to Lakka. 


Set up a controller 

Video game consoles rarely come with 
keyboards. And no doubt you’ll want to attach a 
controller to your console. 

If using a wireless gamepad, insert its dongle 
into one of Raspberry Pi’s USB ports, insert the 
batteries, and turn it on. Press the Start button on 
the gamepad and it will light up. 

Use the arrow keys to choose Input and User 
1 Binds. If it is connected correctly, you will see 
‘RetroPad’ next to User 1 Device Type. 

Scroll down and choose User 1 Bind All. Follow 
the on-screen instructions to press the buttons 
and move the analogue sticks on the gamepad. You 
may have to go through it a few times to get the 
process right. 


You can also set each button individually using 
the options. Once everything is set up correctly, 
you’ll be able to use the gamepad to control your 
Raspberry Pi console. 


Move to the television 

Your Raspberry Pi games console is now 
ready to be moved to your television. You will be 
able to control the games console using your USB 
or wireless controller and move ROM files directly 
to it from your Windows PC or Mac computer. 
There’s a lot more to Lakka to discover, but for now 
we hope you enjoy playing retro games on your 
Raspberry Pi console. ED 


Ask for help 


It’s worth heading 
over the Lakka 
forums for friendly 
help and advice: 

magpi.cc/ 

Lakkaforum 


▼ Match the buttons 
and sticks on a 
gamepad to the 
controls used in 
each core 


User 1 Binds 

± 

User 1 Save AutOCGrtf ig 

13/001 0:14 © 


• 

User 1 Mouse Endex 

Q 


♦ 

User 1 B button (down) 

0(N/AK (Key: 7.) 


# 

User 1 V button (left) 

3(N/A) 

m3 


User 1 5elrct button 

IQ (N/A), {Key: rshift) 

3SS) 

< <=>• 

User 1 Start button 

11 (N/A), {Key: enter) 



User 1 Up D-pad 

Hat m up {N/A), (Key: upy__ 



User l Down O-pad 

Hat AO down (N/A\ (Key: down) 



User 1 Left 

— -HaFSO left (N/A), {Key: left) 


ft 

User 1 Right D-pad 

Hat SO right (N/A), {Key: right) 


♦ 

User 1 A button (right) 

1 (N/A), {Key- it) 



Userl X button {top) 

4 (N/A), {Key: 5 ) 
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Get it fast and for FREE 
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Save up to 35 % compared to stores 


Rolling Monthly Subscription 


► Low monthly cost (from £5) 

► Cancel at any time 

► Free delivery to your door 
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FREE Raspberry Pi 
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► Raspberry Pi Zero W 
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RETRO GAMING 
HARDWARE 


REVIEWS OF THE TOP 
KIT FOR RETRO GAMERS 


22 PICADE 

Pimoroni's mini-bartop 
arcade cabinet 

24 TINYPIPRO 

The smallest retro game console 
you ever saw 

26 WIRELESS USB 

CAME CONTROLLER 

One of the best 
controllers around 

28 DELUXE ARCADE 
CONTROLLER KIT 

An all-in-one arcade joystick 
and case 

30 PI DP-11 

Turn a Raspberry Pi into a 
1970 s computer 


□ Retro gaming consoles need 
a controller - arcade games 
are little fun to play with a 
keyboard and mouse □ 



20 | Retro gaming hardware 






REVIEW 



Picade 


► Pimoroni ► magpi.cc/il_OfHv ► £150/$159 


The new Picade model is sleeker 
with a host of improved features. 
Phil King relives his misspent 
youth down the arcades 

N ew versions of products are usually billed 
as ‘bigger and better’, but Pimoroni’s new 
Picade is smaller than its original mini- 
bartop arcade cabinet. The display is still 8 inches 
(a 10-inch model is also available for £195 / $206), 
however. This time it’s an IPS (in-plane switching) 
panel with wide viewing angles, higher resolution 
(1024x768 compared to the earlier 800x600), and 
a new Pimoroni-designed driver board with HDMI 
input and keypad controls for an on-screen menu. 

Another key improvement is the new Picade X 
HAT, which works with any 40-pin Raspberry 
Pi. Also available separately (£15) for those who 
want to build their own custom arcade cabinet, 
the HAT has easy-to-use DuPont connectors 
for the numerous joystick and button wires. An 
additional ‘Hacker’ header breaks out the few 
remaining unused GPIO pins and PC, which 
could be used to add extra buttons. The HAT 
also features power management and a 
built-in PS DAC with 3W amplifier for mono 
audio - this time there’s only one speaker 
included, although it’s plenty loud enough. 


The new Picade is 
easier to buiLd and 
Looks fabuLous sitting 
on your coffee tabLe 
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A The Picade X HAT has 
easier-to-use connections, 
including a 'Hacker' header 


Before you play on your new Picade, you’ll need 
to assemble it. Taking two to three hours, this is an 
easier process than before, although there are still 
fiddly bits - mainly involving holding the tiny M3 
nuts in hard-to-access places while screwing bolts 

□ Before you can play on 
your new Picade, you'll 
need to assemble it □ 

(tip: use Blu Tack). Full instructions are supplied 
on the reverse of an Ai poster, but we found 
the appended online ones, with videos, easier 
to follow. Assembly is aided by some excellent 
packaging, with separate colour-coded boxes for 
the cabinet, screen, fixings, and accessories. 

Arcade assembly 

Firstly, a few of the black powder-coated MDF 
panels need to be screwed together with plastic 
brackets. Placed upside-down onto a clear acrylic 
panel, the screen display is connected to its rear- 
mounted driver board by a short flat flex ribbon 
cable and care needs to be taken not to pull out 
the connector tabs too far when inserting it. 

Next, add the 30 mm push-fit arcade buttons 
and a microswitched joystick with ball top. Since 
these are standard parts, you could potentially 
customise your Picade by using different (possibly 
illuminated) buttons and joystick topper. 

The wiring is easier than on the original Picade 
due to the DuPont connectors on the HAT, so you 
simply push in the pins of the wires, although the 
other ends still have spade connectors (and there 
are push-fit connectors for the speaker wires). As 
long as you get each wire loom the right way round 


at the HAT end, you should be able to make the 
correct connections for the joystick and buttons. 

In addition to the six control buttons, there are 
four utility buttons placed around the cabinet and a 
light-up yellow power button - simply press this to 
turn the Picade on and off, automatically shutting 
down Raspberry Pi safely - a really nice touch. 

Playtime 

Before turning on, you’ll need to download 
RetroPie and write it to a microSD card - and 
uncomment a line in the boot/config.txt file to 
force HDMI output, to make the display work. 

The card can then be inserted into the Pi mounted 
inside the cabinet via a handy access hole. 
Alternatively, the back panel can easily be removed 
for easy access to all the components. 

A 5 V USB-C power supply (not included) powers 
the Picade X HAT, which in turn powers Raspberry 
Pi, and the display via a USB cable. Hit the power 
button and away you go. Well, not quite. You’ll 
first need to connect a keyboard to Raspberry Pi 
and install the Picade X HAT driver with a one-line 
Terminal command. 

Then it’s just a matter of setting up the joystick 
directions and buttons in the EmulationStation 
menu and - after adding files to RetroPie - playing 
your favourite homebrew games/ 



SPECS 


SCREEN: 

8-inch 
IPS panel, 
1024^768 pixels 

BOARD: 

Picade X HAT 

CONTROLS: 

Joystick, 6 x 
arcade buttons 

SPEAKER: 

3-inch, 5W, 4^ 

DIMENSIONS: 

350 X 230 X 

210 mm 


M Just like the one at 
your Local arcade, only 
much smaller! 


Verdict 


A fun, if at times 
fiddly build, 
this all-new 
Picade features 
high-quality 
components and 
feels sturdy. Major 
improvements 
over the original 
version include a 
vivid, higher-res 
IPS display and 
easier-to-connect 
Picade X HAT. 

9/io 


Retro Gaming with Raspberry Pi | 23 
















REVIEW 


TinyPi Pro 


► PiOcket ► piOcket.com ► £90/$115 


The smallest retro gome console you ever saw, and you can 
make it yourself. Rob Zwetsloot puts one together 


SPECS 


DISPLAY: 

240x240 pixels, 
1.3-inch 

BATTERY: 

Rechargeable 
400 mAh 

DIMENSIONS: 

69 X 34 x 20 mm 

PORTS: 

HDMI out, 

USB in 

STORAGE: 

Swappable 
microSD card 


O riginally known as the Piocket-tiny, the 
TinyPi started out in 2017 as a fun project 
by maker and retro games enthusiast Pete 
Barker. Due to the level of interest, he launched 
a kit so you can make your own extremely small 
game system. 

And we do mean small: the TinyPi Pro (the new, 
upgraded version) is about the same size as a 
Raspberry Pi Zero, albeit just shy of 20 mm deep. 
It’s a pretty remarkable kit in that sense: fitting a 
D-pad, six face buttons, and two shoulder buttons, 
while also including a screen and speaker in the 
chassis is both impressive and a tight squeeze. 

As mentioned above, it does come as a kit, and 
you need to supply your own Raspberry Pi Zero for 
it (GPIO pins not required), as well as a microSD 
card to install an operating system to. 


For a project kit this small, you’d usually be 
required to do a little soldering yourself to ensure 
everything fits as intended. Not so with the TinyPi 
Pro - in fact, the only fastening you need to do is 
with eight screws connecting to four spacers, and 
an Allen key to tighten them is supplied in the kit. 

Tiny build 

With something this small, you also might imagine 
it to be quite fiddly - and the tweezers included 
with the kit will hardly allay those fears. However, 
the only really fiddly part was attaching the (quite 
small) battery. The tweezers worked perfectly for 
that, while everything else just dropped, slotted, 
or clipped into place. 

The packaged instructions make the build look 
simple, and it mostly is: unfortunately, a couple 



A. The kit is nicely laid out, with 
everything in plain view 
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of bits are neglected in the explanation, although 
we’re assured that there will be very fleshed out 
online resources by the time its released, as well 
as some tweaks to the included instructions. 

Tiny power 

Thanks to a combination of RetroPie and the 
power of a Raspberry Pi Zero, the TinyPi Pro has 
the means (and oomph) to play a wide range of 
homebrew games. The RetroPie setup is easy, 
but you need to know how to skip the controller 
configuration once all the available buttons are 
used (tip: hold down any button). 

While there are more than enough buttons for 
the majority of games you’ll be able to play on the 
TinyPi Pro, actually using them all with clumsy 
adult mitts for some games is quite difficult. 
Fingers and thumbs get in the way of each other, 
and you’ll soon get a cramped hand from holding it 
in a way needed to reach the shoulder buttons. We 
found games that didn’t need that many buttons 
worked a lot better, but kids with smaller hands 
might be fine with the full set. 

The small screen is fine, though, and you’ll be 
hard-pressed to find a game where you’ll struggle 
to make out everything that actually runs on your 
Raspberry Pi Zero. 

It’s a lovely kit with a fun, quick build. The final 
result is impressive, but it’s not the very best thing 
to play games on. Still, it fits neatly in a pocket if 
you really need a retro hit out and about, 




▲ Compared to its 
contemporaries, 
it's an incredibly 
smaLL device 

A While the size is 
very convenient it 
does mean it's a little 
awkward to play 


□ We found games that didn't need that 
many buttons worked a lot better □ 



Verdict 


A really neat kit 
that has a fun 
build and an 
amazing final 
product. It’s a 
little too small 
for giant adult 
fingers, but may 
be better suited to 
younger players. 

8/10 
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Wireless USB 

Game Controller 

► The Pi Hut ►magpi.cc/2xpzdph ► £14/ $18 


This versatile controller is easy to set up and great to use 


Verdict 


One of the best 
games controllers 
we’ve found. 
Works right out 
of the box and is 
a comfortable, 
professional, 
and slick piece 
of kit. A perfect 
companion for 
retro gaming. 



R aspberry Pi 4 (or 3) is an excellent base 

for retro gaming projects. With its speedy 
processor and wireless networking, you can 
set up a console in your front room and bounce 
game ROMs to it from another computer. 

Retro gaming consoles need a controller - 
arcade games are little fun to play with a keyboard 
and mouse. And if you’re building a retro games 
console, this Wireless USB Game Controller is a 
great companion device. 

The style will be familiar to gamers. It features a 
D-pad, four buttons, two analogue control sticks, 
and four trigger buttons. In the middle are Select, 
Start, Analog, and a mysterious Turbo button. 

All of this is powered by three AAA batteries, 
which we find easier than charging up via a USB 
cable. On the rear of the device is an on/off switch 
that is used to connect and disconnect from your 
Raspberry Pi. 


The feature we like most is the 2.4GHz wireless 
USB receiver dongle. Instead of going through 
the awkward Bluetooth pairing process, you 
simply plug in the USB dongle and it connects 
straight away. 

We tested it with RetroPie (retropie.org.uk) 
and are pleased to report that it worked first 
time without any issues. As soon as we booted 
into RetroPie, the Wireless USB Game Controller 
appeared as a device, enabling us to assign 
buttons to controls. 

Alternatively, if you want to use Lakka, check out 
the installation guide on page 14, or view a video 
here: magpi.cc/2d0UHrd 

During a game test, we found the Wireless USB 
Game Controller comfortable to hold and perfectly 
fine to use. It’s not quite up there with the original 
DualShock, but it’s not far off, and better than 
most third-party controllers. ED 
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Deluxe Arcade 

Controller Kit 

► Monster Joysticks ► monsterjoysticks.com ► £100/$127 


Rob Zwetsloot builds a mini arcade machine with this 



all-in-one controller kit from Monster Joysticks 


Quality components 

The kit comes with nine genuine Sanwa arcade 
buttons and a Sanwa joystick, which just simply 
click into the acrylic panels as you build them. 

To wire up the buttons and joystick, a little add¬ 
on board is provided with colour-coded wires. 

They can be a little tricky to properly attach to the 
connections as the connectors themselves are a bit 
tight, but you don’t have to worry too much about 
wires getting tangled up. You may also need to 
push down the top panel a bit due to resistance of 
all the wires, but otherwise it all fits fairly neatly 
inside. You can find the full build instructions on 
the Monster Joysticks website: magpi.cc/2i3iQp8. 

The build took us just shy of three episodes of 
The Simpsons , so make sure you set aside about an 
hour for the job. Our only real complaint about the 
build is that, while all the ports and even microSD 
card slot are readily accessible, your Raspberry Pi 
can only be removed by taking the case apart. It 


O n page 146 of this book, we take you through 
a comprehensive arcade machine build, 
including a complete wooden build of the 
cabinet itself. While it’s certainly impressive, not 
everyone has the space, time, or money for one. 
This is where awesome little kits like this one from 
Monster Joysticks come in. 

You’ve probably seen this type of kit before - it’s 
an all-in-one arcade joystick and case for your 
Raspberry Pi that turns it into a small and portable 
arcade machine. Just hook it up to the nearest 
television and you’re ready for some serious retro 
gaming action. 

Unlike the stocking filler plug-and-play 
consoles, this kit requires you to build your 
gaming system and supply a Raspberry Pi board 
to power it. Construction is very simple, though: 
there are six acrylic panels for each side of the 
box and only eight screws required to fasten them 
all together. 
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will only take a couple of minutes to remove it, but 
we’d have preferred it to be a little easier. 

The final part of the build involves attaching 
little rubber feet to the bottom - very welcome, as 
the case had been slipping a bit on the glass table it 
had been built on. 

The stick feels solid and has a decent weight to 
it thanks to the included components, so you feel 
pretty safe giving the buttons and joystick a proper 
workout. The included Sanwa components are 
quite important as not only are they high-quality 
and can survive a bit of classic button mashing/ 
frame-perfect combo-timing, they’re also quite 
customisable. For instance, if you don’t fancy the 
button colour scheme, you can always swap them 
out. The joystick itself can also be customised: 
the version that comes with the kit has square 
four-way gates, but they can be upgraded to an 
octagonal eight-way gate, or any other gate style if 
you prefer. 

Quick configuration 

Software customisation for RetroPie is also very 
simple. With a custom add-on board to connect 


□ The stick feels solid and 
has a decent weight 
to it thanks to the 
included components □ 

the controls to Raspberry Pi over GPIO, we 
initially feared we’d have to download custom 
scripts for the job. Not so, though, and while you 
do need to go into the RetroPie configuration 
menu and install an extra driver, it’s all quick 
and included in the RetroPie archive. Once that’s 
done, you can configure the stick controls, as 
well as any extra controllers you’ve plugged into 
the USB ports. 

This kit is a great, solid package and it looks 
good as well. We recommend investing in some 
nice, long HDMI and USB cables to power the 
box and don’t be afraid to put some sticks or a 
little custom decal onto the case as well. With 
Christmas coming up, it may just be the perfect 
gift for someone. ED 


Verdict 


A great Little kit. 

It’s a fun build 
but also a good 
quality product to 
use. We'd prefer 
our Raspberry Pi 
to be a bit more 
accessible, but 
otherwise the high 
customisability is a 
big plus. 

8/10 
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PiDP-11 

► Obsolescence Guaranteed ► magpi.cc/wgWNTC ► From $250 


Turn □ Raspberry Pi into □ blinktastic classic 1970s computer? 
PJ Evans puts on his Paisley shirt and heats his soldering iron 



SPECS 


DIMENSIONS: 

17*31*6 cm 

MODEL: 

PDP-11/70 

ARCHITECTURE: 

16-bit 

OS: 

RSX-llM Plus 

BLINKENLIGHTS: 

64 


T he launch of Digital’s PDP-8 minicomputer 
in the 1960s was a defining moment 
in computing history, laying down the 
foundations of the hardware and software 
architectures we use today. Both it and the later 
PDP-11 were not only powerful machines, but also 
beautifully designed objects. 

Oscar Vermeulen, an admirer of PDP range, has 
sold over 2000 of his PiDP-8 replica: a Raspberry 
Pi-powered emulator with a fully functional one- 
third scale front-panel. Now comes his PiDP-11 kit. 
Released in 1970, the original PDP-11 is the most 
successful ‘mini’ computer in history, with over 
600,000 sold. 


Remarkable replica 

For this new kit, a painstaking process has resulted 
in an injection-moulded replica of the original 
PDP-11’s case. If not for the one-third scale, you 
would struggle to tell it apart from the real thing. 

A perfect facia and custom-built switchgear 
complete the package. You even get a key and lock, 
just like the real thing. 




A The completed PiDP-11 on 
the provided wooden stand 



Once built, the PiDP-11 PCB comprises 64 LEDs, 
two rotary encoders, and an array of switches 
that connect to Raspberry Pi’s GPIO. Running a 
special version of the SimH emulator, Raspberry 
Pi accurately handles input and output from the 
panel. You can hook up a screen, use SSH, or go 
old-school and implement RS-232. The back panel 
has different cut-outs to suit your cabling. 

Digital-it-yourself 

The PiDP-11 is supplied in kit form and there’s a 
lot to do. You’ll need to have some experience in 
soldering to put this together, the focus being on 
accurately fitting the switches and LEDs. This is 
tricky, but Oscar has provided jigs that make the 
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Verdict 


□ An essential purchase for 
anyone with an interest 
in computing history □ 

alignment of all these components much easier 
than with the PiDP-8. The instructions are in 
an alpha stage, but they are clear and the switch 
section is especially detailed. It took us about five 
hours to complete. 

Full instructions are provided on how to prepare 
Raspberry Pi for its new career in 1970s computing. 
At the time of publication, a one-stop SD card 
image should be available. Otherwise, there are a 


few hoops to jump through, but nothing too arcane 
and the steps are well explained. 

Once you log in, you're straight into the PDP-n’s 
OS, an early form of UNIX. A number of alternative 
OSes are available, with more promised soon. You 
can switch back to Raspbian any time you like. In 
fact, as SimH doesn't put a lot of strain on your 
Raspberry Pi, it’s unlikely to struggle with other 
server tasks. As a result, many users have their 
PiDPs doubling up as file or media servers. 

These kits are a labour of love for Oscar and the 
attention to detail shines through, from the quality 
of the casing to the extensive labelling on the PCB. 
You many find the price high, but the quality is 
there to match. An essential purchase for anyone 
with an interest in computing history, 


The PiDP-11 ticks 
all the boxes. It's 
straightforward to 
build, beautifully 
cased, and 
is endlessly 
customisable. 
Whether you're 
interested in early 
computing or 
hypnotic flashing 
Lights, you'll 
be delighted. 

9/io 
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EMULATE CLASSIC COMPUTERS 
WITH RASPBERRY PI 


34 USING A RETRO COMPUTER 

Have fun with an emulated 
classic computer 


36 AMAZING EMULATORS 

How to use them and what to 
do with them 


38 PUT RASPBERRY PI INSIDE 
A CLASSIC COMPUTER 

Resurrect a ZX Spectrum case 
and keyboard 


42 TURN RASPBERRY PI INTO 
AN AMIGA 

Recapture the glory days of 
16 -bit computing 


44 COMMODORE MONITOR 

A tiny replica monitor created 
for Commodore 64 gaming 


□ Back in the day, you could learn 
a lot by typing in the code given 
away with computer magazines □ 
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COMPUTER 
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USBORNE GUIDE TO 


A beginner’s guide to writing programs 


The Usborne Guide to Better BASIC, 
one of the firm's classic computer books is 
available as a free download 


Image Credit: Usborne Publishing 


W hile playing games and 
writing software are the 
most obvious uses for 
your virtual vintage computer, 
using old-school software 
provides a unique look and feel 
to more artistic projects, too. 

Back when IBM PCs had nothing 
more than a buzzing monophonic 
beeper to communicate with 
the world, the Atari ST and 
Commodore Amiga were creating 
fantastic polyphonic synth tunes. 

The Atari ST’s integrated 
MIDI ports made it very popular 
as a musician’s composition, 
production, and performance tool 
using software such as Cubase. 

At the same time on the Amiga, 
MOD files, first created as a 
native format for the Ultimate 
SoundTracker audio composition 
tool, quickly became ubiquitous, 
and their influence is clearly 
audible in modern chiptune music. 
Freeware ProTracker 3.15 is still a 
popular composition tool. 

The Amiga was also the 
graphical champion of the 16-bit 
home computer world. Electronic 


Arts’ Deluxe Paint was the art 
program of choice for game 
developers and digital artists 
alike. A powerful bitmap graphics 
tool, it was eventually ported 
to MS-DOS, once PC graphics 
technology caught up, and 
produced the original pixel art for 
classic games like The Secret of 
Monkey Island. 


If you fancy turning your hand to 
ray-traced graphics, POV-Ray - 
the Persistence of Vision Raytracer 
- is free and provides old versions 
for download, all the way back to 
its 1992 DOS release. You’ll have 
to get to grips with its text-based 
language for defining the 3D 
objects you wish to render and your 
render times on a Raspberry Pi will 
probably take about as long as they 
would have on a 386 back in the day. 

One of our favourites is 3D 
Construction Kit II (also known as 
3D Virtual Studio) for the Atari, 
Amiga, MS-DOS, and even some 
8-bit systems. Based on the 
Freescape game engine, it lets you 
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A surprising amount of software is still written for 
old-school computers and emulators, with vibrant 
homebrew scenes catering to the Spectrum, C 64 , 
MSX, and CPC. 


create and share interactive 3D 
worlds and games, and feels much 
like Minecraft’s distant ancestor. 

HOME OFFICE 

You can, of course, run old word 
processors and office software - 
WordPerfect 5.1 for DOS provides 
a surprisingly meditative writing 
environment. While professional 
layout and design software from 
the 1980s and 1990s may be best 


You can use software like 3D 
Construction Kit II to create 3D worlds and 
games, and even share them with others 

day are available for free online. 
Usborne still publishes guides to 
modern programming languages, 
and has generously made its 
fantastically illustrated 1980s 
introductions to computers 
and programming available for 
free (scroll down to the bottom 
of magpi.cc/2EsGwR6). 


The Amiga was also the graphical 
champion of the 16 -bit home 
computer world 


SILLY KNIGHT (MS-DOS) 

Award-winning, castle-conquering platformer with 
CGA graphics. 

> magpi.cc/2EbfFJS 

OOZE (ZX SPECTRUM 128K) 

Navigate maze-like levels as a blob of gravity- 
defying goo. 

> magpi.cc/2CgJQti 

TIME OF SILENCE (C64) 

This isometric adventure-RPG is a short but lovely 
exploration of a post-apocalyptic world. 

> magpi.cc/2Emarub 

XIA3X (ZEVIMODOKI) (MSX) 

Cross hostile terrain and shoot down enemy ships 
in the vertically scrolling shoot-’em-up. 

> magpi.cc/2E9cVwC 


forgotten, we can wholeheartedly 
recommend playing with kid- 
friendly design programs like 
Springboard’s The Newsroom Pro 
and Broderbund’s The Print Shop. 
You can even get DOSBox talking 
to a printer if you want to share 
your creations with the world. 

The obvious thing to do with an 
emulated version of a classic is 
to teach yourself to program the 
same way thousands of people - 
including influential developers 
like Jeff Minter, Peter Molyneux, 
Anita Sinclair, and Muriel Tramis 
- got started in the 1980s. 

As well as the remarkably 
informative manuals that 
came with the computers, a 
lot of the materials that got 
developers started back in the 


Back in the day, you could learn 
a lot by typing in the code given 
away with computer magazines. 
Plenty of those have been 
archived online for posterity, 
including full copies of CVG 
(magpi.cc/2E0kU0H), highlights 
from a range of Sinclair Spectrum 
magazines (magpi.cc/2ErDnAP), 
and Acorn-focused Your 
Computer (magpi.cc/2Em9Ybp). 

For later computers, you 
can find whole development 
environments, like STOS The Game 
Creator for the Atari ST and SEUCK 
(Shoot ’Em Up Construction Kit) 
for Commodore systems. As well as 
free homebrew titles, some games 
made for older and emulated 
systems even went on to see 
commercial releases. 


HORACE AND THE ROBOTS 

(ZX SPECTRUM) 

Escape destructive robots in this strategic arcade 
blaster with synthesized voice effects 

> magpi.cc/2E7BSZg 



SOFTWARE 


PROTRACKER 3.15 

> magpi.cc/2EsBtji 

MOD FILES 

> modarchive.org 

3 D CONSTRUCTION KIT 

> 3dc0nstructi0nkit.c0.uk 


POV-RAY 

> magpi.cc/2EnyFUN 

THE NEWSROOM 

> magpi.cc/2EnnpYC 

THE PRINT SHOP 

> magpi.cc/2EmjxHj 
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AMAZING 

EMULATORS 


EMULATORS ARE AVAILABLE FOR 
EVERY RETRO COMPUTER YOU 
CAN THINK OF, BUT NOT ALL OF 
THEM PLAY NICELY WITH THE 
RASPBERRY PL HERE ARE OUR 
FAVOURITES, WITH A BIT OF EXTE 
INFO ON HOWTO USETHEM AND 
WHAT TO DO WITH THEM 
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GLAD TO MEET YOU, MY FRIEND, 



APPLE II: LINAPPLE-PIE 

magpi.CC/2ErIWiC 
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SPECTRUM: FUSE 

magpi.cc/2ErcA7S 

The Free Unix Spectrum Emulator 
(FUSE) is one of the longest- 
running and best-supported 
emulator projects around. It’s in 
the Raspbian and Ubuntu MATE 
repositories, so you can install 
itwithsudo apt install 
fuse-emulator-sdl. 

Before you get cracking, youTl 
want some Spectrum operating 
system ROM files (sudo apt 
install spectrum-roms) and 
utilities (sudo apt install 
fuse-emulator-utils). Press 
Fi to access the menu (and its 
full screen in the options menu, 
needed if you run it from a GUI). 

FUSE opens with a perfect 
emulation of the ZX Spectrum 
BASIC, so you can start 
programming straight away. 


The Apple II was always more 
popular in the USA than in the 
UK, but as an early step on the 
hardware development path 
that led to Apple becoming the 
household name it is today, it 
resulted in the creation of some 
of most influential software ever 
made, particularly games. 

LinApple-Pie provides an 
authentic recreation of the 
Apple II and its implementation 
of BASIC, and is available for 
RetroPie and via GitHub to 
download and compile under any 
Linux-based Raspberry Pi OS. 



hatari.tuxfamily.org 

The Atari ST spent much of the 
1980s and 1990s as the arch-rival 


of the Commodore Amiga for 
home computing, the two 16-bit 
computers having superseded 
the primitive-by-comparison 
8-bit machines. In addition, the 
ST’s integrated MIDI ports and 
generous memory (anywhere 
between 5i2kB and 4MB) saw it 
appearing in music production 
studios across the UK. 

The Hatari emulator supports 
USB MIDI adapters, which means 
you can connect MIDI input 
devices like keyboards and output 
hardware like Roland’s SC-55 
with software such as Cubase 
and Notator. 

You can install Hatari from 
Raspbian’s standard repositories 

(sudo apt install hatari), but 

youTl need ROM images of Atari’s 
TOS (The Operating System), 
which you can learn about at 

magpi.cc/2Em8Fcv and download 
from magpi.cc/2EstrqE. 


• «t*bET 

□ DC CMniiter 32K 
fleam CF3 

easxc 


BEEBEM 


magpi.cc/2E0KAS3 


The BBC Micro isn’t as well 
supplied with emulators as some 
of its more international rivals, 
but although BeebEm hasn’t been 
updated in over a decade, it’s solid 
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and stable. However, compiling it 
involves a couple of extra steps. 

Download beebem-o. 0.13. tar. gz 
and the 64-bit, keys, and 
menu_crash patches. Now: 

sudo apt-get install 
libgtk2.0-dev libsdll.2-dev 
tar -zxvf beebem-0.0.13.tar.gz 

Before you cd into the directory... 

patch -p0 < beebem- 
0.0.13_64bit.patch 
patch -p0 < beebem-0.0.13- 
keys, patch 

patch -p0 < beebem-0.0.13_ 
menu_crash.patch 

cd beebem-0.0.13 

./configure 

sudo make install 

The emulator comes fully loaded 
with operating system ROMs, 
and you can access its settings by 
pressing F12. 


C64: VICE 


magpi.cc/2Erd120 

VICE, the Versatile Commodore 
Emulator, is a fantastically 
authentic emulator that not only 
provides a spot-on reproduction 
of the C64 user experience, but 
also the rest of Commodore’s 
8-bit computer range, including 
the VIC-20 and Plus4. 

To install it under Raspbian, 
enter: sudo apt install vice. 

Once running, you can access 
its menus by pressing F12. A huge 


range of clearly labelled settings 
let you do everything from 
saving programs to connecting 
your emulated computer 
to the internet. 


Urlt-w 1,1 HRBhx U& 74 

F:,r L.ipp.r'rH *hril 

Td JHJ‘1 Ue MMlatefl UD speed. «se *ni 

Til scliUBlr: Lhr krf-i^-|11 ht 

Fur nnr ml Lhn HAHC f E lb I. Lk, DOSI-jh 11^1^ 


fhr MSsiliix Tr.i. MtfL'Aili.feDw# 


IBM-PC: DOSBOX 

dosbox.com 

Emulating DOS software on a 
Raspberry Pi can be a challenge, 
simply because of the huge 
range in required specifications 
between MS-DOS’s first release in 
1981 to its final iteration in 2000. 

DOSBox is available in the 
Raspbian repositories, so 
you can sudo apt install 
dosbox and consult the 
excellent documentation 
(magpi.cc/2EmbSJ3) to get 
your vintage software mounted 
and installed. 

DOS has the widest imaginable 
range of software, from DTP 
programs and office suites to 
fractal generators and games. 
However, depending on your 
Raspberry Pi model, you may 
be best off sticking to software 
released before the mid-1990s. 




tfc> icv=; 




MSX: OPENMSX 


openmsx.org 

The MSX, with its built-in 
Microsoft extended BASIC, 


had near-arcade quality 
games and some of the first 
implementations of the MIDI 
electronic music standard. 

While there are a number 
of good MSX emulators out 
there, OpenMSX is regularly 
updated, extremely faithful, 
and can be found in the standard 
Raspbian repository, so you 
can install it with sudo apt 
install openmsx. 

It even supports MIDI via 
USB adapters and soft synths, 
so you can use the extensive 
range of MSX music utilities 
archived online. 

OpenMSX comes with an open- 
source operating system ROM, 
but this doesn’t include MSX 
BASIC, so you’ll have to hunt 
down original ROM images for 
your MSX before you can write 
your own software. 

AMIGA: AMIBERRY 

magpi.cc/2ErK2ee 


During the late 1980s, the 
Amiga was known for its huge 
range of games and audiovisual 
demos that pushed the limits 
of what Commodore’s systems 
could achieve. 

AmigaOS is still in development, 
with version 4.1 available to 
buy for around £30, while older 
versions of the sort you’ll want 
for emulation are sold by Cloantro 
(amigaforever.com). 

Amiberry is optimised to get 
the best performance out of 
Raspberry Pi and is available via 
RetroPie, as a bootable image, 
and as source code. 

If you compile it 
yourself, follow the 
First Installation 
instructions 
to get all the 
dependencies it 
needs in place. 
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YOU’LL 

NEED 

> A ZX Spectrum 
case with 
keyboard 
membrane 

> Soldering iron 
and solder 

> Ribbon cable 
or wire 

> Sticky pads 
and electrical 
tape to mount 
hardware 

> 2 x Pieces of 
stripboard 
large enough to 
accommodate 
components 
and keyboard 
connectors 

> 8 x Diodes 
(e.g. 1N4148) 

> 2 x Molex 
keyboard 
membrane 
connectors (lx 
5 -pin, lx 8-pin) 

> Push-to-make 
momentary 
contact button 

> ZX Raspberry 
Keyboard 
Scanner 

magpi.cc/ 

2EbikTS 


PUT RASPBERRY PI 

INSIDE A 

CLASSIC 


COMPUTER 


uckily, many ZXt Spectrums 
have made it to 2018 in 
working order, but the 
ones that weren’t so fortunate 
can find new lives as a keyboard 
and case for the Raspberry Pi. 

A Raspberry Pi Zero W fits 
most easily into a Spectrum 


case. There’s space for larger 
models in the raised upper area 
of the case, but the wiring gets 
more complicated. 

Always measure carefully, clean 
everything, double-check all 
positioning, and make sure you 
have enough cable to connect each 


component once everything’s 
in place. 

The Spectrum keyboard uses a 
thin plastic membrane sandwich 
with two layers of electrical 
tracks which form a matrix 




grid of 5x8 tracks. When a key 
is pressed, it creates a circuit 
between two of these tracks. 

Each key ‘lights up’ a unique pair 
of tracks. 

The tracks lead into two ribbon 
cables that go from the keyboard 
assembly to the motherboard. 
The ribbon connectors consist 
of five data lines (KBi) and eight 
address lines (KB2). One wire on 
each will light up per key press. 

The ribbons are extremely 
delicate and normally the 
first thing to fail on a Speccy, 
making keys on the broken 
line unresponsive. Newly 
manufactured replacements are 



available if needed. 

The ribbon cables go to two 
connectors, which we’ll need to 
connect them to your Raspberry 
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A Raspberry Pi Zero is perfect for 
the shallow casing of a classic ZX 
Spectrum. It also allows easy access 
to HDMI and power through the case 


The ZX Spectrum lacks function 
keys, so we use this switch to 
tell Raspberry Pi to remap the 
number keys to Fi, F2, and so on 


We can connect the keyboard 
directly to the GPIO header. You 
can use any available I/O pins, 
but see 'Ribbon solder guide' box 
(p 43 ) for our suggested layout 


These connect the keyboard 
membrane to your Raspberry Pi. The 
stripboard provides stability and the 
diodes prevent short circuits 


Pi’s GPIO. You can harvest 
these from a dead Spectrum 
motherboard or buy online. 

Cut two pieces of stripboard, 
one for each connector. Carefully 
work out where to place these 
in the case, as the ribbons from 
the membrane must not be 
put under any stress. Ideally, 
model their positioning on the 
Spectrum’s original motherboard, 
using masking tape to mark 
their position. 

Spectrum keyboard connectors 
are very delicate. If required on an 
old one, manipulate the contacts 
carefully so they make a good 
connection with the ribbon. 

Most importantly, make sure 
you solder them into position 
the correct way around! Only one 
side of the ribbon has its contacts 
exposed and these need to match 
up with the flat side of each 
connector. KBi connects at the 
bottom, KB2 at the top. 

To support multiple key presses, 
we need to ensure that the current 


from the address lines doesn’t 
short-circuit, so a diode is used to 
protect each line. When soldering 
the stripboards, make sure you cut 
the tracks between the resistors 
and the diode. 


You’ll also notice another 
component: a button. The 
Spectrum keyboard lacks function 
keys, but you’re going to need 
them to control a Raspberry Pi. 

The Keyboard Scanner utility 
includes an alternative keyboard 
mapping mode. When it detects 
a press of our switch, it toggles 
between ‘normal’ mode and a 
second mode that converts the 
number keys into their function 
key equivalent. 


To get your Raspberry Pi working 
with the membrane keyboard 
input, we use a Python script to 
scan the keyboard for presses and 
inject them into the kernel. The 
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When not volunteering at The 
National Museum of Computing 
or running the Milton Keynes 
Raspberry Jam. PJ can be found 
installing Raspberry Pi devices 
where no-one asked them to be. 


mrpjevans.com 


script outputs a current through 
all address lines (KB2) and drops 
the current to each one in turn 
about 60 times a second. 

If a key is pressed, we can 
detect which data line it’s on, 
and we know which address line 
was being checked, so we know 
which key was pressed. The result 
is passed to a piece of software 


KB2 
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CODE 

LANGUAGE: 

Unix 

CODE FILE 
NAME: 

startzxscanner. 

service 

GITHUB LINK: 

magpi.cc/ 

2EbikTS 


called uinput, which turns it 
into a key press. 

The ZX Raspberry Keyboard 
Scanner script is designed to 
work with RetroPie and the FUSE 
Spectrum emulator, but youTl 
find instructions for other distros 
on its home page. 

We can use Git to pull down 
the script and its dependencies. 
First, let’s make sure we have the 
essentials to install everything: 

sudo apt install get 
libudev-dev python-dev 
python-pip 

sudo pip install wiringpi 
Now install Libsuinput: 
cd 

git clone github.com/ 
tuomasjjrasanen/libsuinput 
cd libsuinput 
./autogen 


./configure 

make 

sudo make install 

Make sure uinput is loaded 
every time the Raspberry Pi boots. 
Add the following line to /etc/ 
modules-load.d/modules.conf: 

uinput 

You can load it right away 
without rebooting by typing: 

sudo modprobe uinput 

And install Python-uinput: 

cd 

git clone github.com/ 
tuomasjjrasanen/python- 
uinput 

cd python-uinput 

sudo python setup.py build 

sudo python setup.py install 


Download the scanner script: 

cd 

git clone github.com/ 
mrpjevans/zxscanner 

And test it. Carefully connect 
your ZX Spectrum membrane to 
the Molex connectors and run 
the following from the project 
directory (ideally from an SSH 
session on another computer): 

cd ~/zxscanner 

sudo python zxscanner.py 

Now try the keyboard. Each 
key press should produce a letter 
on screen. The SSF1 session will 
show debug output. Check the 
switch too. 

The script needs to run at 
boot. Start by making the 
file executable: 




Looking quite bare 
compared to the 
original, but with 
buckets more 
power and storage 
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SPACE 


SYMBOL 

SHIFT M 




The Speccy’s 
keyboard matrix allows 
you to detect inputs for 
40 keys using just 13 Lines. 
Perfect for the GPIO 


sudo chmod +x ~/zxscanner/ 

sudo systemctl start 

RIBBON SOLDER 

zxscanner.py 

zxscanner.service 





sudo systemctl daemon-reload 

Solder a ribbon cable from each connector to the 

Then create a service file and 


GPIO as follows: 



enter code from startzxscanner. 

When used with RetroPie and 




service. Our zxscanner.service 

FUSE, a tap on the button will 

BROADCOM GPIO NUMBER I CONNECTOR 1 

LINE 

file needs to contain the following 

cleanly close FUSE, although youTl 

26 

KBl 

1 

so the OS knows how to start 

have to configure the emulator 

19 

KBl 

2 

the scanner: 

not to prompt for confirmation. 

13 

KBl 

3 


A 3-second press will switch the 

6 

KBl 

4 

sudo nano /usr/lib/systemd/ 

keyboard so keys 1-4 become F 

5 

KBl 

5 

zxscanner.service 

keys (so you can get to FUSE’S 

25 

KB2 

l 


menu) and 5-8 act as cursor keys. 

24 

KB2 

2 

Finally, we enable the service so 

A world of ZX Spectrum 

23 

KB2 

3 

the scanner is always running: 

gaming and programming now 

22 

KB2 

4 


awaits you. You can, of course, 

27 

KB2 

5 

sudo systemctl enable 

use your new ZX Raspberry to 

18 

KB2 

6 

/usr/lib/systemd/zxscanner. 

emulate other computers... 

17 

KB2 

7 

service 

even a Commodore 64. n 

4 

KB2 

8 
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Turn Raspberry Pi 

into an Amiga 

Recapture the glory days of 16-bit computing by turning 
your Raspberry Pi into a faithful Amiga emulator 


You’ll Need 


> microSD card 

> USB stick 

> Wired Xbox 
360 controller 

> Amiga Kickstart 
ROMs 

amigaforever.com 

> Amibian 

bit.ly/Amibian 


T he Commodore Amiga’s top-notch sound 
and graphics made it one of the most 
desirable home computers of the 1980s and 
early 1990s, at a time when your average IBM 
PC was still plodding along with EGA graphics 
and an internal beeper. Amiga games from the 
era have aged incredibly well, and look and play 
brilliantly on everything from a portable display 
to a widescreen TV. We’ll take you through 
turning your Raspberry Pi into a perfect modern- 
day Amiga emulator. You’ll need a Windows, 
macOS, or Linux desktop operating system to copy 
the Amibian Linux distribution to your SD card 
and unpack the Kickstart ROMs required to make 
it work smoothly. 



Start by downloading the Amibian distro. 
Format a microSD card, decompress the Amibian 
RAR file, and use Win32DiskImager or Linux’s dd 
command to copy the IMG file to the card. A 4GB 
card should be plenty, as Amibian only occupies 
around 300MB. Slot the microSD card into your 
Raspberry Pi and power up. It’ll boot directly into 
the UAE4ARM emulator, but there’s some extra 
configuration to do before we start playing. Quit 
UAE4ARM to get to the command line and run: 

raspi-config 

Select Expand Filesystem, which will give you 
access to the entirety of the SD card’s capacity for 
storage, then Exit and select Yes to reboot. 

If your Raspberry Pi won’t output sound via 
HDMI properly, enter this at the command line: 

nano /boot/config.txt 

Make sure the following lines are present and 
aren’t commented out with a preceding hash (#): 


hdmi_drive=l 

hdmi_force_hotplug=l 

hdmi_force_edid_audio=l 


Save and return to raspi-config: 

raspi-config 

Select Advanced Options > Audio > Force HDMI 
and then reboot. 

Kickstart me up 

To run Amiga programs, you’ll need a Kickstart 
ROM - firmware from the original computers. 
UAE4ARM comes with the open-source AROS ROM, 
which can run only some Amiga programs, so we 
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recommend using genuine Amiga Kickstarts for 
reliability. The Kickstart ROMs and Workbench 
GUI are still being maintained, thanks to Italian 
firm Cloanto. Amiga Forever Plus Edition, priced at 
€29.95, gets you a complete, legal set of Kickstarts 
for every Amiga computer and console. As there’s 
no Raspberry Pi edition, yet, you’ll currently have 
to install Amiga Forever on a Windows PC or Wine 
and copy the files onto a USB stick. 

There are other ways of obtaining Kickstart 
ROMs, but most are legal grey areas. You can 
extract them from an Amiga using a tool such as 
TransRom or find them on abandonware sites, 
but we strongly recommend supporting Cloanto’s 
continued development of Amiga Forever. 

Classic Amiga software is even easier to find. 
You’ll get 50 games with Amiga Forever Plus, 
while some major publishers have made the 
Amiga versions of their games available for free. 

One true path 

As Amibian doesn’t include a window manager, 
it’s easiest to download and copy everything to a 
USB stick using your operating system of choice. 
Helpfully, UAE4ARM can read Amiga ADF floppy 
images even if they’re in a ZIP file. 

We advise copying everything to your microSD 
card. Start Raspberry Pi, exit UAE4ARM, and run: 

me 

Copy your game files from /media/usb to 
/root/amiga/floppys, and your Kickstart ROMs, 
including a Cloanto rom.key file if you have 
one, to /root/amiga/kickstarts. Quit Midnight 
Commander and reboot: 

reboot 

In the latest version 1.313 of Amibian, two 
different versions of UAE4ARM are supplied. 


If you plan on using two Xbox 360 controllers, 
button mapping on controller two works best 
using the ( old’ version, although the ‘new’ edition 
generally provides more options. To switch 
between the two, at the command line type either 
rpiold or rpinew. The following configuration 
instructions work with both versions. 

Configure UAE4ARM 

First, go to the Paths tab and click Rescan ROMs 
so UAE4ARM knows where to find everything. 

The Configurations tab lets you select from several 
preset hardware emulations, with the default 
being an A1200 - just select and Load your chosen 
computer. You can tweak your virtual hardware in 
the CPU and FPU, Chipset, and RAM tabs. 

Your configuration selection doesn’t always set 
the relevant Kickstart ROM for you, so check the 
ROM tab, where you can choose Kickstarts from a 
pull-down menu. Note that many games require 
a specific ROM or hardware configuration to work 
properly, depending on which system they were 
originally released for. 

To run most software, you’ll need the Floppy 
drives tab. Just press the ... icon next to drive 
DFo’s Eject button, select the desired disk image, 
and click Start. By default only drive DFo is active, 
and most titles expect this configuration. To swap 
disks when prompted, press F12, eject the disk 
image in DFo, select the disk image you’re asked 
for, and click Resume. 

F12 will always pause and return you to 
UAE4 ARM’s main interface, so you can create a 
save state - a stored image of your progress in a 
game - or give up and load something new. The 
Reset, Quit, and Start/Resume buttons are always 
visible in UAE4ARM’s GUI. Reset completely 
reboots your emulation and Resume returns you 
to your current game. 

UAE4ARM automatically detects Xbox 
controllers. You can use two controllers 
for multiplayer gaming - if the second is 
unresponsive, you may need to press F11 to disable 
your mouse and switch control to the pad. If you’re 
running the ‘new’ version of the emulator, first 
select your controllers from the pull-down Porto 
and Porti menus in the Input settings. 

Now you’ve got your Amiga emulator up and 
running, there’s plenty of scope to build on the 
project, from setting up virtual hard disks to 
install Workbench and other software onto, to 
creating floppy images from your own original 
Amiga disks and using Raspberry Pi’s GPIO to 
connect a classic 1980s joystick. EH 


Top Tip 

Publisher- 

approved 

game 

downloads 


Amigaland 

amigaLand.de 

Ami Sector One 

magpi.cc/2dDLELL 

Gremlin Graphics 
World 

magpi.cc/2dDKZ3S 
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MAKER 


PROJECT SHOWCASE 


Commodore 

monitor 


Testing the notion that good things come in small 
packages, this tiny replica monitor was created for 
Commodore 64 gaming, David Crookes reports 



Chris 

Mills 


Chris has had 
an interest in 
computers since 
the Late 1970 s. He 
got a Commodore 
128 in 1985 , and 
says he Likes getting 
things to work as 
much as actuaLLy 
using them. 

magpi.cc/VKPkzy 


► No, that's not a 
huge joystick: it's a 
standard size, but 
it shows just how 
smaLL the monitor 
is. THEC64 Mini sits 
in front 


O ver the years, Raspberry Pi has become a 
firm favourite among enthusiasts of retro 
gaming, thanks to its ability to emulate 
classic computers and consoles from a bygone 
era. Many use packages such as RetroPie to create 
machines capable of playing games from multiple 
systems. These are usually hooked up to the 
makers’ big-screen televisions. 

When Chris Mills decided to emulate the 
Commodore 64, however, he had smaller 
ambitions. Inspired by the recently launched 
miniature, THEC64 Mini, he set about producing 
a tinier version of the age-old Commodore 1702 
monitor. Or at least he did eventually. “The 
original idea was to make a small box to hold the 
monitor and a Raspberry Pi strictly for Commodore 
emulation,” he says. “I wasn’t really planning on 
making it quite as elaborate as it turned out to be. ” 

Mini marvel 

Chris likes Raspberry Pi, which is why, despite 
buying THEC64 Mini and enjoying its plug-and- 
play nature, he prefers using Raspberry Pi for 
his Commodore 64 games. “I can get a lot more 
software to run on it,” he tells us. This is mainly 




▲ CabLes run from the circuit board of the monitor to the back 
of the new case, so that the connectors are easiLy accessible. 
Components are cooled by a fan 


□ You wouldn't believe how 
loud □ 'silent' 50mm fan is 
in a box that size □ 

due to him running the Combian 64 emulator, 
which is a distribution based on an app called Vice. 

“Its single purpose is Commodore emulation, 
and it boots from a cold start to the blue 
Commodore screen in just a few seconds,” he 
explains. “It seems a bit closer to the real hardware 
experience of a Commodore computer to me and 
control seems far less laggy.” Hooked up to the 
monitor and with the mini-C64 to its side, along 
with a joystick, it makes for an impressive setup - 
in appearance alone if nothing else. 

Security monitor 

To achieve the look, Chris chose a small TFT LCD 
security monitor. “It needed to have a 43 aspect 
ratio since the display would be for a computer 
with 320x200 resolution,” he says. “I also wanted 
something that would sit on my desk without 
taking up too much space. I can’t imagine a 
Commodore 64 displaying on a 32-inch television, 
and I grew up with a 13-inch CRT for my computers 
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> The project cost a 
total of $120 


■*** COMMODORE 
ROM SYSTEM 3 ; 


The Commodore 64 was 
renowned for its SID music chip 
that deserve to be heard at their 
best. "I may add a headphone 
jack to connect to a larger 
sound system," Chris tells us 


Thanks to Combian 64, Chris 
found there was nothing 
to do except configure the 
display and fiddle with the 
emulation settings 


Chris would like to use Raspberry Pi’s GPIO 
pins to light an LED to show data transfers, 
but he’s happy his Raspberry Pi/monitor 
combo lets him play his favourite C64 games 


Quick FACTS 


so an 8-inch size seemed like a nice compromise 
for space versus readability. ” 

The HD monitor was placed inside a wooden 
case which Chris designed and crafted himself. He 
removed the back of the display, connected wires 
to the newly created back of the retro monitor, and 
wired a pair of two-inch speakers - which proved 
the trickiest part. 

“I didn’t find out that the speaker mounting 
holes and the bezel holes didn’t line up until I 
went to put the speakers in the enclosure,” he 
says. He also added a series resistor to drop the fan 
voltage from 12 V to 4V. “You wouldn’t believe how 
loud a ( silent’ 50mm fan is in a box that size,” he 
laughs. “All these years, I’ve been mistaken in my 
interpretation of the world ‘silent’.” 

For the finishing touch, the box was fine- 
sanded as smoothly as possible and painted using 
Krylon spray enamel, wet-sanded with 2000 grit 


paper between coats. Chris then took a photo of 
a Commodore badge from one of his real 1702 
monitors. “I cropped the picture and made a metal¬ 
looking Commodore logo,” he says. This was placed 
on the front of the mini monitor. “It’s had a great 
reaction from Commodore fans. ” ED 



> It took around 25 
hours to make 

> The case is made 
of painted wood 

> Raspberry Pi uses 
the C64 emulator, 
Combian 64 

> Currently, 
Raspberry Pi sits 
outside the monitor 


M Front and back, the 
monitor looks like a 
professional Labour 
of love, with a nice 
retro-styLe finish 
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MAKE YOUR 
OWN GAMES 


PROGRAM RETRO-STYLE 
GAMES WITH PYGAME ZERO 


48 GET STARTED WITH PYGAME ZERO 

Start writing computer games on Raspberry Pi 

54 SIMPLE BRIAN 

Recreate a classic electronic game 

60 SCRAMBLED CAT 

Create a sliding tile puzzle game 

66 PIVADERS PARTI 

Start making a single-screen shoot-'em-up 

74 PIVADERS - PART 2 

Add sound effects, high scores, levels, and more 

82 HUNGRY PI-MAN PARTI 

Code your own classic maze game 

90 HUNGRY PI-MAN - PART 2 

Add better enemy AI, power-ups, levels, and sound 

100 AMAZEBALLS - PART 1 

Start programming an isometric 3 D game 

106 AMAZEBALLS - PART 2 

Create a larger, scrolling 3 D maze map 

112 AMAZEBALLS PART 3 

Improve your game with enemies and dynamite 


□ Pygame Zero is a great choice for anyone who 
wants to start writing computer games □ 


46 | Make your own games 



MAKER 


TUTORIAL 



Mark 

Vanstone 


Educational 
software author 
from the nineties, 
author of the 
ArcVenture series, 
disappeared into 
the corporate 
software wasteland. 
Rescued by the 
Raspberry Pi! 

magpi.cc/YiZnxl 

@mindexplorers 


You'll Need 


> Raspbian 

> An image 
manipulation 
program such 
as GIMP 

> A little imagination 

> A keyboard 


Get started with 

Pygame Zero 

Pygame Zero is o great choice for anyone who wants 
to start writing computer games on Raspberry Pi 


I f you’ve done some Python coding and wanted 
to write a game, you may have come across 
Pygame. The Pygame module adds many 
functions that help you to write games in Python. 
Pygame Zero goes one step further to let you skip 
over the cumbersome process of making all those 
game loops and setting up your program structure. 
You don’t need to worry about functions to load 
graphics or keeping data structures for all the game 
elements. If you just want to get stuck in and start 
making things happen on the screen without all 
the fluff, then Pygame Zero is what you need. 


Loading a suitable program editor 

■■■ The first really labour-saving thing about 
Pygame Zero is that you can write a program 
in a simple text editor. We advise using the 
Thonny Python editor, as Pygame Zero needs to 
be formatted like Python with its indents and 
you’ll get the benefit of syntax highlighting to 
help you along the way. So the first step in your 
journey will be to open Thonny, found in the 
Programming section of the Raspbian main menu 
(click the raspberry icon). You’ll be presented 
with a window featuring three panes. 


01 



The Terminal window 
- enter the command 
to run our program 


Our program listing, 
shown in the top pane 
of the Thonny IDE 


The Pygame Zero 
game appears in a 
separate window 


48 | Get started with Pygame Zero 









































DOWNLOAD 
THE FULL CODE: 


racel.py 


> Language: Python 


[© magpi.cc/pgzerol 


Writing a Pygame Zero program 

The top pane is where you will write your 
code. To start writing your first Pygame Zero 
program, click the Save icon and save your blank 
program - we suggest saving it as pygamei.py 
in your default user folder (just save the file 
without changing directory). And that’s it: you 
have written your first Pygame Zero program! 

The Pygame Zero framework assumes that you 
will want to open a new window to run your game 
inside, so even a blank file will create a running 
game environment. Of course at this stage your 
game doesn’t do very much, but you can test it to 
make sure that you can get a program running. 


Running your first 
Pygame Zero program 

With other Python programs, you can run them 
directly from the Python file window. While there 
is a method to enable you to do so with a Pygame 
Zero program (see part 2 of this tutorial series), 
let’s use the simple alternative for now. All you 
need to do then is open a Terminal window from 
the main Raspbian menu, and type cd pygame- 
zero and type in pgzrun pygamel. py (assuming 
you called your program pygamei.py) and then 
hit RETURN. After a few seconds, a window titled 
'Pygame Zero Game’ should appear. 


Setting up the basics 

By default, the Pygame Zero window opens 
at the size of 800 pixels wide by 600 pixels high. 

If you want to change the size of your window, 
there are two predefined variables you can set. If 
you include WIDTH = 700 in your program, then 
the window will be set at 700 pixels wide. If you 
include height = 800 , then the window will be set 
to 800 pixels high. In this tutorial we’ll be writing 
a simple racing game, so we want our window to be 
a bit taller than it is wide. When you have set the 
width and height variables, you could save your file 
as racel.py and test it like before by typing pgzrun 
racel. py into the Terminal window. 


Look! No game loop! 

When writing a Python game, normally 
you would have a game loop - that’s a piece of 
code that is run over and over while the game is 


001. from random import randint 

002. import pgzrun 

003. 

004. WIDTH = 700 # Width of window 
005. HEIGHT = 800 # Height of window 

006. car = Actor ("racecar") # Load in the car Actor image 

007. car.pos = 250., 700 # Set the car screen position 

008. SPEED = 4 

009. trackCount = 0 

010. trackPosition = 250 

011. trackWidth = 120 

012. trackDirection = False 

013. trackLeft = [] # list of track barriers left 

014. trackRight = [] # list of track barriers right 

015. gameStatus = 0 
016. 

017. def drawQ: # Pygame Zero draw function 

018. global gameStatus 

019. screen. fill( (128, 128, 128)) 

020. if gameStatus == 0: 

021. car.draw() 

022. b = 0 

023. while b < len (trackLeft): 

024. trackLeft[b] .drawQ 

025. trackRight[b] .drawQ 

026. b += 1 

027. if gameStatus == 1: 

028. # Red Flag 

029. screen. blit ('rflag'j (318, 268)) 

030. if gameStatus == 2: 

031. # Chequered Flag 

032. screen. blit ('cflag', (318, 268)) 

033. 

034. def update(): # Pygame Zero update function 
035. global gameStatus , trackCount 

036. if gameStatus == 0: 

037. if keyboard.left: car.x -= 2 

038. if keyboard.right: car.x += 2 

039. updateTrack() 

040. if trackCount > 200: gameStatus = 2 # Chequered flag state 

041. 

042. def makeTrackO : # Function to make a new section of track 

043. global trackCount, trackLeft, trackRight, trackPosition, trackWidth 

044. trackLeft. append(Actor("barrier", pos = (trackPosition-trackWidth,0))) 

045. trackRight. append(Actor( "barrier , pos = (trackPosition+trackWidth,0))) 

046. trackCount += 1 

047. 

048. def updateTrack() : # Function to update where the track blocks appear 

049. global trackCount, trackPosition, trackDirection, trackWidth, 

gameStatus 
050. b = 0 

051. while b < len(trackLeft): 

052. if car.colliderect(trackLeft[b]) or car. colliderect (trackRight[b]): 

053. gameStatus = 1 # Red flag state 

054. trackLeft[b].y += SPEED 

055. trackRight[b].y += SPEED 

056. b += 1 

057. if trackLeft[Len(trackLeft)-l].y > 32: 

058. if trackDirection == False: trackPosition += 16 

059. if trackDirection == True: trackPosition -= 16 

060. if randint (0, 4) == 1: trackDirection = not trackDirection 

061. if trackPosition > 700-trackWidth: trackDirection = True 

062. if trackPosition < trackWidth: trackDirection = False 

063. makeTrack() 

064. 

065. # End of functions 

066. makeTrack() # Make first block of track 

067. 

068. pgzrun. go() 
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► To respond to key 
presses, Pygame 
Zero has a buiLt- 
in object called 
keyboard. The arrow 
key states can be 
read with keyboard, 
up, keyboard.down, 
and so on 



figurel.py 


► Language: Python 


001. WIDTH = 700 
002. HEIGHT = 800 
003. 

004. def draw( ): 

005. screen. fill((128, 128, 128)) 


▲ Figure l To set the 

height and width 
of a Pygame Zero 
window, just set the 
variables HEIGHT and 
WIDTH. Then you can 
fill the screen with 
a colour 


Top Tip 4 


The graphics 


If you use PNG 
files for your 
graphics rather 
than JPGs, you 
can keep part 
of the image 
transparent. 


running. Pygame Zero does away with this idea 
and provides predefined functions to handle 
each of the tasks that the game loop normally 
performs. The first of these we will look at is 
the function draw( ). We can write this function 
into our program the same as we would normally 
define a function in Python, which is def draw():. 
Then, so that you can see the draw function doing 
something, add a line underneath indented by one 
tab: screen.fill((l28, 128, 128) ). This is shown 
in the figurel.py listing overleaf. 


The Python format 

You may have noticed that in the previous 
step we said to indent the screen. fill line by one 
tab. Pygame Zero follows the same formatting 
rules as Python, so you will need to take care to 
indent your code correctly. The indents in Python 
show that the code is inside a structure. So if you 
define a function, all the code inside it will be 
indented by one tab. If you then have a condition 


or a loop, for example an if statement, then the 
contents of that condition will be indented by 
another tab (so two in total). 


All the world's a stage 

The screen object used in Step 5 is a 
predefined object that refers to the window we’ve 
opened for our game. The fill function fills the 
window with the RGB value (a tuple value) provided 
- in this case, a shade of grey. Now that we have 
our stage set, we can create our actors. Actors 
in Pygame Zero are dynamic graphic objects, 
much the same as sprites in other programming 
systems. We can load an actor by typing car = 

Actor("racecar"). This is best placed near the top 
of your program, before the draw() function. 


07 


It's all about image 

When we define an actor in our program, 
what we are actually doing is saying ( go and get 
this image’. In Pygame Zero our images need to 
be stored in a directory called images, next to 
our program file. So our actor would be looking 
for an image file in the images folder called 
racecar.png. It could be a GIF or a JPG file, but it 
is recommended that your images are PNG files 
as that file type provides good-quality images 
with transparencies. You can get a full free image 
creation program called GIMP by typing sudo 
apt-get install gimp in your Terminal window. 
If you want to use our images, you can download 
them from magpi.cc/pgzeroi. 
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Drawing your Actor 

Once you have loaded in your image by 
defining your actor, you can set its position on 
the screen. You can do this straight after loading 
the actor by typing car. pos = 250, 500 to set it at 
position 250, 500 on the screen. Now, when the 
draw() function runs, we want to display our race 
car at the coordinates that we have set. So, in our 
drawQ function, after the screen.fill command 
we can type car. drawQ. This will draw our race 
car at its defined position. Test your program to 
make sure this is working, by saving it and running 
pgzrun racel. py, as before. 


I'm a control freak! 

Once we have our car drawing on the 
screen, the next stage is to enable the player 
to move it backwards and forwards. We can 
do this with key presses; in this case we are 
going to use the left and right arrow keys. We 
can read the state of these keys inside another 
predefined function called updateQ. We can 
type in the definition of this function by adding 
def updateQ : to our program. This function is 
continually checked while the game is running. 
We can now add an indented if statement to 
check the state of a key; e.g., if keyboard. left:. 


10 


Steering the car 

We need to write some code to detect 
key presses of both arrow keys and also to do 
something if we detect that either has been 
pressed. Continuing from our if keyboard. left: 
line, we can write car. x -= 2. This means subtract 
2 from the car’s x coordinate. It could also be 
written in long-hand as car.x = car.x - 2. Then, 
on the next line and with the same indent as the 
first if statement, we can do the same for the right 
arrow; i.e., if keyboard.right: car.x += 2. These 
lines of code will move the car actor left and right. 


The long and winding road 

Now that we have a car that we can steer, we 
need a track for it to drive on. We are going to build 
our track out of actors, one row at a time. We will 
need to make some lists to keep track of the actors 
we create. To create our lists, we can write the 
following near the top of our program: trackLeft = 


figure2.py 


> Language: Python 


001. def makeTrackQ: # Function to make a new section of track 

002. global trackCount, trackLeft, trackRight, 

trackPosition, trackWidth 
003. trackLeft. append(Actor("barrier", pos = 

(trackPosition-trackWidth, 0) )) 

004. trackRight. append(Actor("barrier", pos = 

(trackPosition+trackWidth, 0) )) 

005. trackCount += 1 


[ ] (note the square brackets) and then, on the next 
line, trackRight = []. This creates two empty lists: 
one to hold the data about the left side of the track, 
and one to hold the data about the right-hand side. 


Figure 2 The 

makeTrackO function. 
This creates two 
new Actors with the 
barrier image 
at the top of 
the screen 


Building the track 

We will need to set up a few more variables 
for the track. After your two lists, declare the 
following variables: trackCount = 0 and then 
trackPosition = 250,then trackWidth = 120, 
and finally trackDirection = false. Then let’s 
make a new function called makeTrack (). Define 
this function after your updateQ function. See 
the figure2.py listing for the code to put inside 


T Figure 3 The 

updateTrackO 
function. Notice 
the constant 
SPEED - we need 
to define this at the 
top of our program, 
perhaps starting 
with the value 4 


figure3.py 


> Language: Python 


001. def updateTrackQ : # Function to update where the track 
blocks appear 

002. global trackCount, trackPosition, trackDirection, 

trackWidth 
003. b = 0 

004. while b < len(trackLeft): 

005. trackLeft[b].y += SPEED 

006. trackRight[b].y += SPEED 

007. b += 1 

008. if trackLeft[len(trackLeft)-l].y > 32: 

009. if trackDirection == False: trackPosition += 16 

010. if trackDirection == True: trackPosition -= 16 

011. if randint(0, 4) == 1: trackDirection = not 

trackDirection 

012. if trackPosition > 700-trackWidth: trackDirection = 

True 

013. if trackPosition < trackWidth: trackDirection = False 

014. makeTrackQ 
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► The race car with 
barriers making up a 
track to stay within. 
The track pieces are 
created by random 
numbers so each 
play is different 

▼ Figure 4 The dnaw() 
function and the 
update() function 
with conditions 
(if statements) to 
do different things 
depending on the 
value of gameStatus 



figure4.py 

> Language: Python 


001. 

def 

draw(): # Pygame Zeno draw function 

002. 


global gameStatus 

003. 


screen .fill( (128, 128, 128)) 

004. 


if gameStatus == 0: 

005. 


car.drawQ 

006. 


b = 0 

007. 


while b < len(trackLeft): 

008. 


trackLeft[b] .drawQ 

009. 


trackRight[b] .drawQ 

010. 


b += 1 

011. 


if gameStatus == 1: 

012. 


# Red Flag 

013. 



014. 


if gameStatus == 2: 

015. 


# Chequered Flag 

016. 



017. 

def 

updateQ: # Pygame Zero update function 

018. 


global gameStatus , trackCount 

019. 


if gameStatus == 0: 

020. 


if keyboard.left: car.x -= 2 

021. 


if keyboard.right: car.x += 2 

022. 


updateTrackQ 

023. 


if trackCount > 200: gameStatus = 2 # Chequered 


flag state 



makeTrack(). The function will add one track actor 
on the left and one on the right, both using the 
image barrier.png. Each time we call this function, 
it will add a section of track at the top of the screen. 


On the move 

The next thing that we need to do is to 
move the sections of track down the screen 
towards the car. Let’s write a new function called 
updateTrack( ). We will call this function in our 
update () function after we do the keyboard checks. 
See the figure3.py listing for the code for our 
updateTrackQ function. In this function we are 
using randint (). This is a function that we must 
load from an external module, so at the top of our 
code we write from random import randint. We use 
this function to make the track curve backwards 
and forwards. 


Making more track 

Notice at the bottom of the updateTrack() 
function, there is a call to our makeTrack() 
function. This means that for each update when 
the track sections move down, a new track section 
is created at the top of the screen. We will need 
to start this process off, so we will put a call to 
makeTrack() at the bottom of our code. If we run 
our code at the moment, we should see a track 
snaking down towards the car. The only problem 
is that we can move the car over the track barriers 
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and we want to keep the car inside them with some 
collision detection. 


A bit of a car crash 

We need to make sure that our car 
doesn’t touch the track actors. As we are 
looking through the existing barrier actors in 
our updateTrack() function, we may as well test 
for collisions at the same time. We can write 


if car .colliderect(trackl_eft[b]) or 
car.colliderect(trackRight[b] ): and then, 
indented on the next line, gameStatus = l. We have 
not covered gameStatus yet - we’ll use this variable 
to show if the game is running, the car has crashed, 
or we’ve reached the end of the race. Define your 
gameStatus variable near the top of the program as 
gameStatus = 0. You will also need to add it to the 
global variables in the updateTrackQ function. 


Changing state 

In this game we will have three different 
states to the game stored in our variable gameStatus. 
The first or default state will be that the game is 
running and will be represented by the number o. 
The next state will be set if the car crashes, which 
will be the number l. The third state will be if 
we have finished the race, which we’ll set as the 
number 2 in gameStatus. We will need to reorganise 
our draw( ) function and our update( ) function to 
respond to the gameStatus variable. See the 
figure4.py listing for how we do that. 



A Each of the barrier 
blocks is checked 
against the car to 
detect collisions. If 
the car hits a barrier, 
the red flag graphic 
is displayed 


Finishing touches 

All we need to do now is to display 
something if gameStatus is set to l or 2. If 
gameStatus is l then it means that the car has 
crashed and we should display a red flag. We can 
do that with the code: screen.blit(' rflag', (318, 
268) ). To see if the car has reached the finish, we 
should count how many track sections have been 
created and then perhaps when we get to 200, set 
gameStatus to 2. We can do this in the update() 
function as in figurespy. Then, in the draw() 
function, if the gameStatus is 2 , then we can write 
screen, blit ('cflag', (318, 268) ). Have a look at 
the full code listing to see how this all fits together. 


Top Tip 4 


Run from IDE 


Since the upgrade 
to version 1.2, 
programs can be 
run straight from 
Thonny by adding 
import pgzrun 
to the top of the 
code and pgzrun. 
go() at the bottom. 


Did you win? 

If you didn’t get the program working first 
time, you are not alone - it’s quite rare to have 
everything exactly right first time. Check that 
you have written all the variables and functions 
correctly and that the capital letters are in the right 
places. Python also insists on having code properly 
formatted with indents. When it’s all in place, 
test your program as before and you should have a 
racing game with a chequered flag at the end! ED 



A The official Pygame 
Zero documentation 
can be found at 

magpi.cc/fBqznh 


Top Tip 4 


Changing the 
speed 


If you want to 
make the track 
move faster 
or slower, try 
changing the 
value of SPEED 
at the start of 
the program. 
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Py game Zero 

Simple Brian 


You'll Need 


Recreate □ classic electronic game using Pygame Zero 


> Raspbian 

> An image 
manipulation 
program such 
as GIMP, or 
images from 
magpi.cc/pgzer02 

> The Latest 
version of 
Pygame Zero 

> A good memory 


L ong, long ago, before Raspberry Pi existed, 
there was a game. It was a round plastic 
box with four coloured buttons on top 
and you had to copy what it did. To reconstruct 
this classic game using Pygame Zero, we’ll first 
need a name. To avoid any possible trademark 
misunderstandings and because we are using 
the Python language, let’s call it ‘Brian’. The 
way the game works is that Brian will show you 
a colour sequence by lighting up the buttons and 
then you have to copy the sequence by pressing 
the coloured buttons in the same sequence. Each 
round, an extra button is added to the sequence 
and you get a point for each round you complete 
correctly. The game continues until you get the 
sequence wrong. 


Instructions are The game has four 

displayed here coloured buttons that light 

up when they are pressed 


Run, run as fast as you can 

In the previous tutorial (page 48), we ran 
code by typing the pgznun command in a Terminal 
window. With the 1.2 update of Pygame Zero, 
however, there is now a way to run your programs 
directly from a Python editor such as Thonny, by 
adding a couple of lines of code (see figurei.py). 


The stage is set 

We’ll need some images that make up the 
buttons of the Brian game. You can make your own 
or get ours from GitHub at magpi.cc/pgzer02. The 
images will need to be in an images directory next 
to your program file. We have called our starting 
images redunlit, greenunlit, blueunlit, and 
yellowunlit because all the buttons will be unlit at 
the start of the game. We have also got a play button 
so that the player can click on it to start the game. 



fariesB 


BIB 




m 


Getting the actors on stage 

We can create actors by supplying an image 
name and a position on the screen for it to go. 
There are several ways of supplying the position 
information. This time we’ll use position handles 
to define where the character appears. We will 


figurei.py 


> Language: Python 


001. import pgzrun 
002 . 

003. # Your program code will go here 

004. 

005. pgzrun. go() 
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topleft 


midtop 


topright 


midleft 



bottomleft 


midbottom 


midnight 


bottomright 


There are nine positions that an Actor's co-ordinates can 
be aligned to when the Actor is created 


use the same coordinates for each quadrant of the 
whole graphic, but we’ll change the handle names 
we use. For these actors we can use bottomright, 
bottomleft, topright, and topleft, as well as the 
coordinates (400,270), which is the centre point of 
our whole graphic. Take a look at figure2.py. 


Look at the state of that 

We now need to add some logic to determine 
if each button is on or off and show it lit or unlit 
accordingly. We can do this by adding a variable to 
each of our actors. We want it to be either on or off, 
so we can set this variable as a Boolean value, i.e. 
True or False. If we call this variable state, we can 
add it to the Actor by writing (for the first button): 
myButtons[0] .state = False. We then do the same 
for each of the button actors with their list numbers 
1, 2, and 3 because we defined them as a list. 


Light goes on, light goes off 

We have defined a state for each button; 
now we have to write some code to react to that 
state. First, let’s make a couple of lists which hold 
the names of the images we will use for the two 
states. The first list will be the images we use for 
the buttons being lit, which would be: buttonsLit = 
['redlit', 'greenlit', 'bluelit', 'yellowlit']. 
We then need a list of the unlit buttons: 


buttonsllnlit = ['redunlit', ' greenunlit' , 

' blueunlit' , ' yellowunlit ' ]. Then we can use 
these lists in an update () function to set the image 
of each button to match its state. See figures.py. 


Switching images 

We can see from figures.py that each time 
our update () function runs, we will loop through 


figure2.py 

DOWNLOAD 

THE FULL CODE: 

> Language: Python 

magpi.cc/pgzero2 


001. import pgzrun 

002 . 

003. myButtons = [] 

004. myButtons. append (Actor ( 'redunlit', bottomright= (400,270))) 
005. myButtons. append (Actor ( 'greenunlit' , bottomleft= (400,270))) 
006. myButtons. append ( Actor ( 'blueunlit A topright= (400, 270))) 

007. myButtons. append ( Actor ( 'yellowunlit' ,topleft= (400, 270))) 
008. playButton = Actor (' play’ , pos=(400,540)) 

009. 

010. def drawQ: # Pygame Zero draw function 
011. screen. fill( (30, 10, 30)) 

012. for b in myButtons: b. drawQ 

013. playButton. drawQ 

014. 

015. pgzrun. go() 


figure3.py 


> Language: Python 


001. import pgzrun 

002 . 

003. myButtons = [] 

004. myButtons. append (Actor (' redunlit' , bottomright=(400,270))) 
005. myButtons[0].state = False 

006. myButtons. append ( Actor ( 'greenunlit', bottomleft=(400,270))) 
007. myButtons[1].state = False 

008. myButtons. append (Actor ( 'blueunlit' ,topright=(400, 270))) 

009. myButtons[2].state = False 

010. myButtons. append ( Actor ( 'yellowunlit' ,topleft= (400, 270))) 
011. myButtons[3].state = False 

012. buttonsLit = ['redlit', 'greenlit', 'bluelit', 'yellowlit'] 
013. buttonsllnlit = [ redunlit', 'greenunlit', 'blueunlit', 
'yellowunlit' ] 

014. playButton = Actor( 'play' , pos=(400,540)) 

015. 

016. def drawQ: # Pygame Zero draw function 
017. screen. fill( (30, 10, 30)) 

018. for b in myButtons: b. drawQ 

019. playButton. drawQ 

020 . 

021. def updateQ: # Pygame Zero update function 

022. bcount = 0 

023. for b in myButtons: 

024. if b.state == True: b.image = buttonsLit[bcount] 

025. else: b.image = buttonsllnlit[bcount] 

026. bcount += 1 

027. 

028. pgzrun. goQ 
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figure4.py 

> Language: Python 


001. 

def on_mouse_down(pos) : 


002. 

global myButtons 


003. 

for b in myButtons: 


004. 

if b. collidepoint(pos) : 

b.state 

005. 



006. 

def on_mouse_up(pos) : 


007. 

global myButtons 


008. 

for b in myButtons: b.state 

= False 


figure5.py 

> Language: Python 

001 . 

def playAnimation( ): 

002. 

global playPosition., playingAnimation 

003. 

playPosition = 0 

004. 

playingAnimation = True 

005. 


006. 

def addButtonQ : 

007. 

global buttonList 

008. 

buttonList .append(nandint(0, 3)) 

009. 

playAnimation( ) 


figure6.py 


> Language: Python 


001. def updateQ: # Pygame Zeno update function 

002. global myButtons., playingAnimation., playPosition 

003. if playingAnimation: 

004. playPosition += 1 

005. listpos = math.floon(playPosition/LOOPDELAY) 

006. if listpos == len(buttonList): 

007. playingAnimation = False 

008. cleanButtons( ) 

009. else: 

010. litButton = buttonList[listpos] 

011. if playPosition%LOOPDELAY > L00PDELAY/2: 

litButton = -1 
012. bcount = 0 

013. for b in myButtons: 

014. if litButton == bcount: b.state = True 

015. else: b.state = False 

016. bcount += 1 




redunlit.png redlit.png 

▲ When the mouse is clicked on a button, we switch the unlit 
image for the lit image 


our button list. If the button’s state is True, we 
set the image of the button to the image in the 
buttonsLit list. If not (i.e. the state variable is 
False), we set the image of the button to the image 
in the buttonsllnlit list. 


What happens if I press this button? 

We need to write a way to allow the user 
to press the buttons and make them light up. 

We can do this with the Pygame Zero functions 
on_mouse_down() and on_mouse_up(). If the mouse 
has been clicked down, we should set our button 
state to True. We also need to test if the mouse 
button has been released; if so, all the buttons 
should be set to False. We can test the value we are 
passed (pos) into these functions with the method 
collidepoint (), which is part of the actor object. 


Ups and downs 

We can write a test in on_mouse_down() 
for each button, to see if it has been pressed, 
and then change the state of the button if it has 
been pressed. We can then write code to set all 
the button states to False in the on_mouse_up() 
function, and our updateQ and drawQ functions 
will now reflect what we need to see on the screen 
from those actions. Look at figure4.py and you will 
see how we can change the state of the buttons as 
a response to mouse events. When you have added 
this to your program, test it to make sure that the 
buttons light up correctly when clicked. 


Write a list 

Now that we have our buttons working, we 
will need to make a way to use them in two different 
ways. The first will be for the game to display a 
sequence for the player to follow, and the second is 
to receive input from the player when they repeat 
the sequence. For the first task we will need to build 
a list to represent the sequence and then play that 
sequence to the player. Let’s define our list at the 
top of the code with buttonList = [ ] and then make 
a function def addButton (): which will create an 
additional entry into the sequence each round. 
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That's a bit random 

We can generate our sequence by generating 
random integers using the random module. We 
can use this module by importing it at the top of 
our code with: from random import randint.As 
we only need the randintQ function, we import 
that function specifically. To add a new number to 
the sequence in the addButtonQ function, we can 
write buttonList.append(randint(0j 3)), which 
will add a number between o and 3 to our list. Once 
we have added our new number, we will want to 
show the player the sequence, so add a line in the 
addButtonQ function: playAnimationQ. 


Playing the animation 

We have set up our function to create the 
sequence. Now we need a system to play the latter 
so the player can see it. We’ll do this with a counter 
variable called playPosition. We define this at the 
start of our code: playPosition = 0. We’ll also need 
a variable to show that our animation is playing: 
playingAnimation = False, also written at the start 
of the code. We can then define our playAnimationQ 
function that we used in the previous step. Look 
at figure5.py to see how the addButtonQ and 
playAnimationQ functions are written. 


Are we playing? 

So, once we have set our animation going, 
we will need to react to that in our update() 
function. We know that all we need to do is change 
the state of the buttons and the draw( ) function 
will handle the visuals for us. In our update() 
function, we have to say: “If the animation is 
playing then increment our animation counter, 
check that we haven’t reached the end of the 
animation and if not then light the button (change 
its state to True) which is indicated by our sequence 
list.” This is a bit of a mouthful, so in figure6.py 
we can see how this translates into code. 


Getting a bit loopy 

We can see from figure6.py that we are 
incrementing the play position each time update() 
is called. What we want to do is keep each button 
in the sequence lit for several refreshes, so we 
divide the playPosition by a predefined number 
(loopdelay) to get our list position that we want to 


display. We round the result downwards with the 
math.floorQ function (to use this, we import the 
math module at the top of the code). So if LOOPDELAY 
is 80, we’ll move from one list position (listpos) to 
the next every 80 times update () is called. 


A dramatic pause 

Still in figure6.py, we check to see if we have 
reached the end of the buttonList with listpos. If 
we have then we stop the animation. Otherwise, 
if we are still running the animation, we work out 
which button should be lit from our buttonList. We 
could just say “light that button and set the rest 
to unlit”, but before we do that we have a line that 
basically says: “If we are in the second half of our 
button lighting loop, set all the buttons to unlit.” 
This means that we will get a pause in between each 
button being lit when no buttons are lit. We can 
then just loop through our buttons and set their 
state according to the value of litButton. 


Top Tip 


Globals 


You can read 
global variables 
inside a function, 
but if you change 
the value of the 
variable, you 
must declare it 
as global in the 
function. 


Testing the animation 

Now, ignoring the fact that we have a play 
button ready and waiting to do something, we 
can test our animation by calling the addButtonQ 
function. This function adds a random button 
number to the list and sets the animation in 
motion. To test it, we can call it a few times at the 
bottom of our code, just above pgzrun. goQ . If we 
call the addButtonQ function three times then three 
numbers will be added to the buttonList and the 
animation will start. If this all works, we are ready 
to add the code to capture the player’s response. 


I need input 

We can collect the player’s clicks on the 
buttons just by adding another list, playerlnput, to 
the definitions at the top of the code and adding a 
few lines into our on_mouse_down() function. Add 
a counter variable bcount = 0 at the top of the 
function and then add one to bcount at the end of 


the loop. Then, after if b.collidepoint(pos) : we 
add playerlnput .append (bcount). We can then test 
the player input to see if it matches the buttonList 
we are looking for. We will write this as a separate 
function called checkPlayerlnputQ and call it 
at the end of our on_mouse_down() function. As 
we now have the basis of our game, refer to the 


Top Tip 


Modulo or % 


The % symbol 
is used to get 
the remainder 
after a division 
calculation. 

It’s useful for 
creating smaller 
repeats within a 
Larger Loop. 
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Top Tip A 


Changing 
the delay 


We have used 
the constant 
LOOPDELAYfor 
timing our Loops, 
if the game is 
running too 
slow, decrease 
this value at the 
top of the code. 


Top Tip A 


Using text 


If you are going 
to use text, it's 
a good idea to 
display some on 
the first screen 
as it can take 
a while to load 
fonts for the first 
time. You may 
get unwanted 
delays if you 
load it Later. 


full listing to see how the rest of the code comes 
together as we go through the final steps. 


Game over man 

The checkPlayerInput( ) function will check 
the buttons that the player has clicked against 
the list held in buttonList, which we have been 
building up with the addButton() function. So we 
need to loop through the playerlnput list with 
a counter variable - let’s call it ui, and write if 


playerlnput[ui] != buttonList[ui]: gameOver(). 

If we get to the end of the list and both playerlnput 
and buttonList are the same length then we know 
that the player has completed the sequence and we 
can signal that the score needs to be incremented. 
The score variable is defined at the top of the code 
as score = 0. In our on_mouse_up( ) function, we can 
then respond to the score signal by incrementing 
the score and setting the next round in motion. 


Just press play 

We still haven’t done anything with that 
play button actor that we set up at the beginning. 
Let’s put some code behind that to get the game 
started. Make sure you have removed any testing 
calls at the bottom of your code to addButton() 
(Step 15). We’ll need a variable to check if the 
game is started, so put gameStarted = False at the 
top of the code with the other variables and then 
in our on_mouse_up( ) function we can add a test: if 


playButton.collidepoint(pos) and gameStarted 
== False: and then set the gameStarted variable to 
True. We can set a countdown variable when the 
play button is clicked so that there is a slight pause 
before the first animation starts. 


Finishing touches 

We’re nearly there with our game: we have 
a way to play a random sequence and build that list 
round by round, and we have a way to capture and 
check user input. The last things we need are some 
instructions for the player, which we can do with 
thePygame Zero screen.draw.text() function. We 
will want an initial ‘Press Play to Start’ message, a 
‘Watch’ message for when the animation is playing, 
a ‘Now You’ message to prompt the player to 
respond, and a score message to be displayed when 
the game is over. Have a look in the draw( ) function 
in the complete listing to see how these fit in. 

There are many ways we can enhance our game; 
for example, the original electronic game featured 
sound - something we cover later (see page 74). ED 


brian.py 

> Language: Python 3 

001. 

import pgzrun 

002. 

from random import randint 

003. 

import math 

004. 

WIDTH = 800 

005. 

006. 

HEIGHT = 600 

007. 

myButtons = [] 

008. 

myButtons. append (Actor ( 'redunlit' , 
bottomright=(400, 270) )) 

009. 

myButtons[0].state = False 

010. 

myButtons. append ( Actor ( 'greenunlit' , 
bottomleft=(400, 270) )) 

011. 

myButtons[1].state = False 

012. 

myButtons. append ( Actor ( 'blueunlit' , 
topright=(400, 270) )) 

013. 

myButtons[2].state = False 

014. 

myButtons. append (Actor ( 'yellowunlit' , 
topleft=(400, 270) )) 

015. 

myButtons[3].state = False 

016. 

buttonsLit = ['redlit', 'greenlit', 

'bluelit', 'yellowlit ] 

017. 

buttonsUnlit = [' redunlit' , 

'greenunlit', 'blueunlit', 

'yellowunlit' ] 

018. 

playButton = Actor (' play' , 
pos=(400,540) ) 

019. 

buttonList = [] 

020. 

playPosition = 0 

021. 

playingAnimation = False 

022. 

gameCountdown = -1 

023. 

LOOPDELAY = 80 

024. 

score = 0 

025. 

playerlnput = [] 

026. 

signalScore = False 

027. 

028. 

gameStarted = False 

029. 

def drawQ: # Pygame Zero draw 
function 

030. 

global playingAnimationj score 

031. 

screen. fill((30, 10, 30)) 

032. 

for b in myButtons: b. drawQ 

033. 

if gameStarted: 

034. 

screen.draw. text ("Score 
: " + str(score), (310, 540), 
owidth=0.5, ocolor=(255, 255,255) , 
color=(255, 128,0) , fontsize=60) 

035. 

else: 

036. 

playButton. draw( ) 

037. 

screen.draw. 

text ("Play", (370, 525), 
owidth=0. 5, ocolor=(255,255,255), 
color=(255,128,0) , fontsize=40) 

038. 

if score > 0: 

039. 

screen.draw. text ( "Final 
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Scone : " + str(score), (250, 20), owidth=0.5, 081. 

ocolor=(255,255,255), color=(255,128,0) , 082. 

fontsize=60) 083. 

040. else: 

041. screen.draw. text("Press Play to Start", 084. 

(220, 20), owidth=0.5, ocolor=(255,255,255), 085. 

color=(255,128,0) , fontsize=60) 086. 

042. if playingAnimation or gameCountdown > 0: 

043. screen.draw. text ("Watch", (330, 20), 087. 

owidth=0. 5, ocolor=(255,255,255), color=(255,128,0) 088. 

, fontsize=60) 089. 

044. if not playingAnimation and gameCountdown == 0: 090. 

045. screen.draw. text ("Now You", (310, 20), 091. 

owidth=0. 5, ocolor=(255, 255, 255) , color=(255,128,0) 

, fontsize=60) 092. 

046. 093. 

047. def updateQ: # Pygame Zero update function 094. 

048. global myButtons, playingAnimation, 095. 

playPosition, gameCountdown 096. 

049. if playingAnimation: 097. 

050. playPosition += 1 098. 

051. listpos = math.floor( playPosition/LOOPDELAY) 099. 

052. if listpos == len(buttonList) : 100. 

053. playingAnimation = False 101. 

054. clearButtonsQ 102. 

055. else: 

056. litButton = buttonList[listpos] 103. 

057. if playPosition%LOOPDELAY > LOOPDELAY/ 2: 104. 

litButton = -1 105. 

058. bcount = 0 

059. for b in myButtons: 106. 

060. if litButton == bcount: b.state = True 107. 

061. else: b.state = False 108. 

062. bcount += 1 109. 

063. bcount = 0 110. 

064. for b in myButtons: 111. 

065. if b.state == True: b.image = 112. 

buttonsLit[bcount] 113. 

066. else: b.image = buttonsUnlit[bcount] 114. 

067. bcount += 1 115. 

068. if gameCountdown > 0: 116. 

069. gameCountdown -=1 117. 

070. if gameCountdown == 0: 118. 

071. addButtonQ 119. 

072. playerlnput. clear () 120. 

073. 121. 

074. def gameOverQ: 122. 

075. global gameStarted, gameCountdown, playerlnput, 123. 

buttonList 124. 

076. gameStarted = False 125. 

077. gameCountdown = -1 126. 

078. playerlnput. clear () 127. 

079. buttonList. clear () 128. 

080. clearButtonsQ 129. 


def checkPlayerlnputQ : 

global playerlnput, gameStarted, score, 
buttonList, gameCountdown, signalScore 
ui = 0 

while ui < len(playerlnput): 

if playerlnput[ui] != buttonList[ui]: 

gameOverQ 

ui += 1 

if ui == len(buttonList): signalScore = True 

def on_mouse_down(pos) : 

global myButtons, playingAnimation, 
gameCountdown, playerlnput 

if not playingAnimation and gameCountdown == 0: 
bcount = 0 
for b in myButtons: 

if b.collidepoint(pos) : 

playerlnput. append(bcount) 
b.state = True 
bcount += 1 
checkPlayerlnput () 

def on_mouse_up(pos) : 

global myButtons, gameStarted, gameCountdown, 
signalScore, score 

if not playingAnimation and gameCountdown == 0: 

for b in myButtons: b.state = False 
if playButton.collidepoinf (pos) and gameStarted 
== False: 

gameStarted = True 
score = 0 

gameCountdown = LOOPDELAY 
if signalScore: 
score += 1 

gameCountdown = LOOPDELAY 

clearButtonsQ 

signalScore = False 

def clearButtonsQ: 
global myButtons 

for b in myButtons: b.state = False 

def playAnimationQ : 

global playPosition, playingAnimation 
playPosition = 0 
playingAnimation = True 

def addButtonQ: 

global buttonList 

buttonList. append(randint(0, 3)) 

playAnimationQ 

pgzrun.goQ 
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Pygame Zero 

Scrambled Cat 


You’ll Need 

> Raspbian 


In this third tutorial of the series, we introduce several new programming 
techniques to create a sliding tile puzzle game 


> An image 
manipulation 
program such 
as GIMP, or 
images from 
magpi.cc/pgzer03 

> The latest version of 
Pygame Zero 

> A Lot of patience 
to play the game 


W hen your author first came across this 
type of game, it was in the form of 
a plastic frame with numbered tiles 
and was handed to him by his grandmother to 
keep him quiet for a while. It’s an infuriating 
game much like a 2D forerunner to the Rubik’s 
Cube, where the player must move jumbled up 
tiles around the frame to put them back into the 
correct order, except that there is only one spare 
space to move tiles into and you seem to end up 
with an ever more jumbled collection of tiles. In 
this version, the author’s cat, Widdy, has very 
kindly donated himself to be scrambled. 


Decisions, decisions 

When first approaching a sliding tile 
game, our first thought would be to have a matrix 
variable (or two-dimensional list) representing 
the frame with its tiles. You would then have 
a process function to handle the tiles moving 
around, changing the values in each of the matrix 
positions. However, Pygame Zero has a few 
tricks up its sleeve which work very well in this 
circumstance. Pygame Zero actors are your friends 
and can save you a huge wedge of coding time. 
Let’s get stuck in and set your program up with a 
few standard Pygame Zero basics, as in figurei.py. 


Tile images are cut from a Background wooden 

single image and measure frame image cut 

iooxioo pixels each from a coffee table 



Getting the groundwork done 

You may notice that there are several 
functions in figurei.py with just the keyword pass 
in them. In Python we aren ( t allowed to have an 
empty function, so if we write pass in it, it means 
that the function should do nothing. This enables 
us to build the basic structure of our program before 
we start thinking about the finer details. Now that 
we have our structure, we can add some background 
graphics. If you have downloaded the graphics 
from our GitHub link (magpi.cc/pgzer03), we can 
add a background colour with screen. fill(red, 
green, blue) and then c blit’ a frame using screen. 
blit('board', (150, 50)) in the drawQ function. 


A night on the tiles 

A stylish frame is now displayed if you 
run the program.This will serve as the holder for 
the tiles. All we need to do to create the tiles is 
to define a list to hold the tile Actors and then a 
function to create and arrange the new actors in 
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Top Tip A 


Writing your 

program 

structure 


When creating 
your own 

programs, you can 
start by writing 
a structure of 
empty functions 
before writing the 
detailed code. 

This can help to 
visualise the way 
the program 
will work. 


the frame. We can do this with a double loop to set 
the x and y coordinates of each tile. So first, define 
the tile list near the top of the code using tileList 
= [ ] and then a function to make the tiles. Have a 
look at figure2.py (overleaf) to see how we can do 
that. We can call our makeTiles () function at the 
end of the code, just before pgzrun. go(). 


Stating the obvious 

One technique that we have used in both 
previous tutorials in this series is to use a variable 
to keep track of the overall state of the game, and 
this game is no different. We need to know if the 
player is allowed to interact with the tiles or if 
they have completed the puzzle and a few other 
things too. For this we can define a global variable 
gameStatus = 0 near the top of our program. In this 
game we will use the value o to allow the player to 
interact with the tiles, then 1 to show that a tile is 
being moved; 2 will mean that we are preparing the 
game (more on this later), and 3 will show that the 
player has completed the puzzle. 


Point and click 

We’ll be using two different types of user 
input to give the player a choice of how to control 
the tiles. Players can click on a tile to get it to move 
into the spare space, or use the arrow keys. These 
two input methods work quite differently, so let’s 
look at mouse input first. Pygame Zero provides a 


figurel.py 


> Language: Python 


001 . import pgzrun 
002. WIDTH = 800 
003. HEIGHT = 600 
004. gameStatus = 0 
005. 

006. def draw(): # Pygame Zero draw function 

007. pass 

008. 

009. def updateQ: # Pygame Zero update function 

010 . pass 

011 . 

012 . def on_mouse_down(pos) : 

013. pass 

014. 

015. pgzrun. go() 


▲ Figure 1 The basic setup for our Pygame Zero program 

function on_mouse_down(pos) so we can capture a 
mouse click. We then compare the coordinates in 
the variable pos to the tiles to see if they collide. If 
they do, then the player has clicked on a tile. 


Which tile? 

To check which tile was clicked, we can 
use a for loop. We know how many tiles we have 
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figure2.py 

> Language: Python 

001 . 

def makeTilesQ : 

002 . 

global tileList 

003. 

xoffset = 251 

004. 

yoffset = 151 

005. 

x = y = c = 0 

006. 

while y < 4: 

007. 

while x < 4: 

008. 

if (c < 15): 

009. 

tileList .append(Actor ( "img"+stn(c) j pos 
= (xoffset+(x*100) ,yoff set+(y*100) ))) 

010 . 

c += 1 

011 . 

x += 1 

012 . 

x = 0 

013. 

T—1 

II 

+ 


▲ Figure 2 The makeTiles () function. We Loop from 0-3 with y and inside the Loop from 0-3 with x 


□ If no collision is detected, we know that 
we can move the tile that way □ 


figure3.py 

> Language: Python 

001 . 

def on_mouse_down(pos) : 

002 . 

if (gameStatus == 0): 

003. 

doLockQ 

004. 

for t in range(15) : 

005. 

if tileList[t]. collidepoint(pos) : 

006. 

m = moveTile(tileList [t]) 

007. 

if(m != False): 

008. 

animate(tileList[t] ,on_ 


finished=releaseLockj pos=(tileList [t].x+m[l], 
tileList[t].y+m[2])) 

009. 

return True 

010 . 

releaseLock( ) 

011 . 


012 . 

def releaseLockQ : 

013. 

global gameStatus 

014. 

gameStatus = 0 

015. 


016. 

def doLock( ): 

017. 

global gameStatus 

018. 

gameStatus = 1 


▲ Figure 3 Using a Locking system whiLe pLayer inputs are being processed 


(15)) so we can say for t in range(l5):, where the 
variable t will be our counter. We can then check 
each tile to see if it has been clicked, with if 
tileList[t]. collidepoint(pos) :. While we are 
dealing with moving the tile, it’s a good idea to 
stop the player from interacting with the game, 
otherwise we may get several tiles trying to move 
at once. We can change the gameStatus variable to l 
to lock the input. See the figure3.py listing for how 
this works in the code. 


Let's get things moving 

You may notice in f igure3. py, in 
the middle of the for loop there is a call to 
moveTile(tilel_ist[t] ). This is a function that will 
determine which way a tile can move. We are going 
to use the colliderect( ) method of our tile actors 
to test all directions. If no collision is detected in a 
certain direction then we know that we can move 
the tile that way. We’ll also include a condition to 
test that the tiles cannot move outside the frame, 
so we’ll be using two types of collision detection: 
one with the built-in Pygame Zero actor objects 
and one with a boundary check. 


Repel borders! 

First, we need to stop the tiles being 
allowed through the frame border. We can do this 
with a simple if condition for each direction. So 
for the right border we would say if (tile. x < 
borderRight) : and then we would do our actor 
collision test. We will need a border test for each 
direction. What we are actually doing in the 
moveTileQ function is saying: “Can we move the 
tile right, or left, or up, or down?” If the answer to 
any of those is yes (and it can only be one of them 
or none), then tell us which way to move. 


Tiles to the left, tiles to the right 

There is a cunning plan you can use to test if 
a tile can move in a certain direction without seeing 
it move. If you add 1 to the x coordinate of the tile 
and then test for a collision - we are going to use a 
function called checkCollide(tile) - then we will 
know if a tile is to the right of our test tile. We then 
set the tile back to its original position by subtracting 
1 from the x coordinate, and all this happens before 
the Pygame Zero draw( ) function is called again so 
you never see anything move. We can also do the 
same test for moving right, up, and down. 
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Collision course 

We need to write a function that will test 
to see if a collision has happened when we moved 
our tile l unit (pixel). The checkCollide( ) function 
loops through the tile list and checks to see if 
any of the tiles are colliding with the tile that the 
player has clicked on. We just loop through the tile 
list and use the colliderectQ method to test for 
collision (and also make sure we are not testing the 
tile that has been clicked) and if there is, return 
True. If no collision was detected then the function 
will exit with a False return value. Take a look at 
figure4.py to see how we test a border and check for 
tile collision. 


Very animated 

We will need to add tests for left, up, and 
down to our moveTile( ) function; when that is 
done, it will return what is known as a tuple. This is 
a return value with several parts: the direction as a 
string, the x offset to move the tile, and the y offset 
to move the tile. This tuple gets sent back to our 
on_mouse_down() function and if it’s not False then 
we know we can move the tile based on the return 
values. We now call the animate () function. This is 
a Pygame Zero function to move an actor from one 
place to another. 


12 

Locking player interaction 

While we are animating the tile moving, 


14 


we don’t want the player to be able to click on any 
other tiles. We have used our doLock() function 
to change the gameStatus to l so that no mouse 
clicks are reacted to. When the animation has 
finished, we want the player to make their next 
move, so in our call to animate () we include 
on_f inished=releaseLock. This will call the 
function releasel_ock( ) which will set the 
gameStatus back to 0. This will mean that the 
player can click on another tile. You will notice 
from the figure3.py code listing that if the mouse 
click is not on a tile then the lock is released at the 
end of the function. 


Using the arrows 

The second way that we can capture 
the player’s input is to use the arrow keys. This 
form of input relies on the fact that if an arrow 
key is pressed (for example the up arrow), there is 
only one tile that is able to move in that direction 


figure4.py 


> Language: Python 


001 . 

def moveTile(tile) : 


002 . 

bondenRight = 551 


003. 

rValue = False 


004. 

if (tile.x < borderRight): # can 

we go right? 

005. 

tile.x += 1 


006. 

if (not checkCollide(tile) ): 

100 , 0 

rValue = "right". 

007. 

008. 

tile.x -= 1 


009. 

010 . 

return rValue 


011 . 

def checkCollide(tile) : 


012 . 

for t in range(15) : 


013. 

if tile.colliderect(tileList[t] ) and tile != 
tileList[t]: return True 

014. 

return False 



▲ Figure 4 An example of testing border collision and then using the Actor collision detection 

- or alternatively, no tiles are able to move in that 
direction. So all we need to do is work out which 
tile can move in the direction of the arrow pressed. 

We are going to do this with a function called 
findMoveTile(moveDirection) and we pass it the 
direction of movement that we want it to look for. 


Scanning the keyboard 

First, we must check if the player is 
pressing one of the arrow keys. We do this in 
our update () function. We want to check if the 
gameStatus is 0 before processing anything; if 
it is, we can check the left arrow key by writing 
if keyboard.left: findMoveTile("left"). We 
then write a similar line of code for each of the 
other arrow keys, passing a different string to our 
findMoveTileQ function. In the latter function we 
use the same moveTile () function as we did with 
the mouse click input, but this time we check for 
the direction that has been passed by the keyboard 
press check. 


Which tile is it? 

Now all we need to do is write the 
findMoveTileQ function that scans through the 
tile actors and finds the one that can move in the 
direction that the player has pressed. We loop 
though our tile list and try to move each tile. If 
we find it can move then we check the direction 
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figureS.py 


> Language: Python 


001. def updateQ: # Pygame Zeno update function 
002. if (gameStatus == 0): 

003. if keyboard.left: findMoveTile("left") 

004. if keyboard.right: findMoveTile(" right") 

005. if keyboard.up: findMoveTile("up") 

006. if keyboard.down: findMoveTile("down") 

007. 

008. def findMoveTile(moveDirection) : 

009. doLockQ 

010. for t in range(15): 

011. m = moveTile(tileList[t]) 

012. if(m != False): 

013. if(m[0] == moveDirection): 

014. animate(tilel_ist[t],on_finished=releaseLock, 

pos=(tileList[t],x+m[l], tileList[t].y+m[2])) 

015. return True 

016. releaseLockQ 

017. return False 


figure6.py 

> Language: Python 

001 . 

scrambleCountdown = 30 

002 . 

scrambleList = [2, 0, 2 , 0 , 3, 1 , 1, 1, 3, 0, 0, 2, 1, 
2 3 1 3 3, 3, 0 3 3 3 0 3 2 3 0 3 2 3 2 3 1 3 3 3 1 3 3 3 3 3 1 3 2 ] 

003. 


004. 


005. 

def scrambleCatQ : 

006. 

global gameStatus, scrambleCountdown, scrambleList 

007. 

tileDirs = ["left", "right", "up 1 , "down"] 

008. 

if (scrambleCountdown > 0): 

009. 

mt = False 

010 . 

while(mt == False): 

011 . 

mt = findMoveTile(tileDirs[ scrambleList 


[ scrambleCountdown ]]) 

012 . 

scrambleCountdown -= 1 

013. 

gameStatus = 2 

014. 

else: 

015. 

gameStatus = 0 


▲ Figure 5 Moving tiles 
from the detection of a 
press of the arrow keys 


of movement. If it matches the direction that 
we are looking for then we have a match and we 
can initiate the animation to move the tile. The 


A Figure 6 scrambleCat() 
function. Pass a list of 
simulated keystrokes to 
f indMoveTile( ), just 
as if we were pressing 
the keys 


figures.py code listing shows this whole process, 
from key press to animation. Note that we are 
locking and unlocking the gameStatus while this is 
happening, to avoid multiple moves at once. 


Time to scramble the cat 

The game is not much fun if we start with 
a completed puzzle, so we need to add a system 
for mixing up the tiles. There are various ways 
to do this, but we thought it’d be nice if we start 
the game with the tiles being scrambled move by 
move. We can do this by simulating key presses 
using the same functions as in the previous steps. 
We can use a new gameStatus of 2 to indicate that 
the player can’t interact, then cycle through a 
predefined or random set of simulated key presses 
until everything is jumbled up. We have used a 
predefined list in this case. 


How scrambled is scrambled? 

For our scrambling, we can have a list of 
movements. If we alter the number of movements 
we are using then the game becomes more or 
less difficult. We can start at 30 and see how that 
works. Our scrambling function, scrambleCat(), 
calls the findMoveTileQ function and uses the 
scrambleCountdown variable to check if we have 
made enough moves. After each animation, we 
are using a cunning trick: we always call the 
releaseLock( ) function after an animation so we 
can slip in a test to see if gameStatus is 2 and if so, 
call scrambleCat() again. See figure6.py for the 
scrambleCat( ) function. 


Have we won yet? 

At some point, there is a chance the player 
will rearrange the tiles into the correct order. We’ll 
need to write a check to see if this has happened 
each time a tile has been moved. We know that 
the positions of the tiles were correct before we 
scrambled them, so we can make a list of the x and 
y coordinates of each tile when we first make the 
tile actors. Then all we need to do is to compare 
that list with the current x and y values of our tile 
actors and if they all match, we have a winner! 


Finishing touches 

You can see from the full program listing 
how the checkSuccess() function works. We 
can also add some text prompts into our draw() 
function based on the value of gameStatus. That’s 
about it! We have a working Scrambled Cat game. 
You may want to add some features such as a score 
based on how many moves the player makes. Or 
change the images: you could have scrambled egg 
or a scrambler bike or make the tile matrix larger 
for an even more difficult challenge. EU 
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scrambledcat.py 





DOWNLOAD 

THE FULL CODE: 

> Language: Python 3 

magpi.cc/pgzero3 

001 . 

import pgzrun 

060. 

if (tileList[t]. 

x != correctList[t][0] or 

002 . 

WIDTH = 800 


tileList[t].y != correctList[t][1]): 

003. 

HEIGHT = 600 

061. 

return 0 


004. 

gameStatus = 0 

062. 

return 3 # we 

have success! 

005. 

tileList = [] 

063. 



006. 

correctList = [] 

064. 

def makefiles (): 


007. 

scrambleCountdown = 30 

065. 

global tileList, correctList 

008. 

scrambleList = [2, 0, 2, 0, 3, 1, 1, 1, 3, 0 , 0 , 2 , 

066. 

xoffset = 251 



1 , 2 , 1 , 3 , 3 , 0 , 3 , 0 , 2 , 0 , 2 , 2 , 1 , 3, 1 , 3, 3, 

067. 

yoffset = 151 



h 2] 

068. 

x = y = c = 0 


009. 


069. 

while y < 4: 


010 . 

def drawQ: # Pygame Zero draw function 

070. 

while x < 4: 


011 . 

global gameStatus 

071. 

if (c < 15): 


012 . 

screen. fill((141, 172, 242)) 

072. 

tileList. append (Actor ( "img"+str (c), 

013. 

screen. blit ( 'board' , (150, 50)) 


pos = (xoffset+(x* 100 ),yoffset+(y* 100 )))) 

014. 

for t in range(15): 

073. 

correctList. 

015. 

tileList[t] .draw() 


append ((xoff set+(x* 100 ) ,yoff set+(y* 100 ) )) 

016. 

if (gameStatus == 3): screen.draw. 

074. 

c += 1 



text ("Success!" , (315, 20), owidth=0.5. 

075. 

x += 1 



OCOlon= (255,255,255), color=(128,64,0) , 

076. 

x = 0 



fontsize=60) 

077. 

y += 1 


017. 

if (gameStatus == 2): screen.draw. text ("Please 

078. 

scrambleCatQ 



wait while we scramble the cat", (135, 540), 

079. 




owidth=0.5, ocolor=(255,255,255), color=(128,64,0) 

080. 

def scrambleCatQ: 



, fontsize=40) 

081. 

global gameStatus, 

scrambleCountdown, 

018. 

if (gameStatus <= 1): screen.draw. text ("Click 


scrambleList 



on a tile to move it or use the arrow keys". 

082. 

tileDirs = ["left". 

"right", "up", "down"] 


(95, 540), owidth=0.5, ocolor= (255,255,255), 

083. 

if (scrambleCountdown > 0): 


color=(128,64,0) , fontsize=40) 

084. 

mt = False 


019. 


085. 

while(mt == False): 

020 . 

def updateQ: # Pygame Zero update function 

086. 

mt = findMoveTile(tileDirs[scrambleList 

021 . 

if (gameStatus == 0): 


[scrambleCountdown]]) 


022 . 

if keyboard.left: findMoveTile("left") 

087. 

scrambleCountdown -= 1 

023. 

if keyboard.right: findMoveTile(" right") 

088. 

gameStatus = 2 


024. 

if keyboard.up: findMoveTile("up") 

089. 

else: 


025. 

if keyboard.down: findMoveTile("down' ) 

090. 

gameStatus = 0 


026. 


091. 



027. 

def on_mouse_down(pos) : 

092. 

def moveTile (tile ): 


028. 

if (gameStatus == 0): 

093. 

borderRight = 551 


029. 

doLockQ 

094. 

borderLeft = 251 


030. 

for t in range(15): 

095. 

borderTop = 151 


031. 

if tileList[t]. collidepoint(pos) : 

096. 

borderBottom = 451 


032. 

m = moveTile (tileList[t]) 

097. 

rValue = False 


033. 

if(m != False): 

098. 

if (tile.x < borderRight): # can we go right? 

034. 

animate(tileList[t] ,on_ 

099. 

tile.x += 1 



finished=releaseLock, pos=(tileList[t].x+m[l]. 

100. 

if (not checkCollide(tile)) : rValue = 


tileList[t].y+m[2])) 


"right' , 100, 0 


035. 

return True 

101. 

tile.x -= 1 


036. 

releaseLockQ 

102. 

if (tile.x > borderLeft): # can we go left? 

037. 


103. 

tile.x -= 1 


038. 

def findMoveTile(moveDirection) : 

104. 

if (not checkCollide(tile)) : rValue = 

039. 

doLockQ 


"left", -100, 0 


040. 

for t in range(15): 

105. 

tile.x += 1 


041. 

m = moveTile(tileList[t]) 

106. 

if (tile.y < borderBottom): # can we go down? 

042. 

if(m != False): 

107. 

tile.y += 1 


043. 

if(m[0] == moveDirection): 

108. 

if (not checkCollide(tile)) : rValue = 

044. 

animate(tileList[t],on_ 


"down", 0, 100 



finished=releaseLock, pos=(tileList[t].x+m[l]. 

109. 

tile.y -= 1 



tileList[t].y+m[2])) 

110. 

if (tile.y > borderTop): # can we go up? 

045. 

return True 

111 . 

tile.y -= 1 


046. 

releaseLockQ 

112. 

if (not checkCollide(tile)) : rValue = "up". 

047. 

return False 


0, -100 


048. 


113. 

tile.y += 1 


049. 

def releaseLockQ: 

114. 

return rValue 


050. 

global gameStatus 

115. 



051. 

if (gameStatus == 2): scrambleCatQ 

116. 

def checkCollide(tile) : 


052. 

else: gameStatus = checkSuccessQ 

117. 

for t in range(15): 


053. 


118. 

if tile.colliderect(tileList[t]) and tile 

054. 

def doLockQ: 


!= tileList[t]: return 

True 

055. 

global gameStatus 

119. 

return False 


056. 

gameStatus = 1 

120. 



057. 


121. 

makeTilesQ 


058. 

def checkSuccessQ: 

122. 

pgzrun. goQ 


059. 

for t in range(15): 
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Pygame Zero 

PiVaders 


There must be very few people who have not played a 
shooting game, and for some it may have been their 
very first experience of a computer game 


You'll Need 

Raspbian 

An image 
manipulation 
program such 
as GIMP, or 
images from 
magpi.cc/pgzero4 


T he shooting-style game format requires 
quite a few different coding techniques to 
make it work. For some time, if your author 
needed to learn a new coding language, he would 
task himself to write an invaders game in it. This 
would give a good workout through the syntax and 
functions of the language. 


This tutorial will be split into two parts. 

In the first we will build a basic shooting game 
with aliens, lasers, defence bases, and a score. 
The second part (page 74) will add all the 
extra bits that make it into a game similar to the 
one that appeared in amusement arcades and 
sports halls in the late 1970s. 


> The Latest version of 
Pygame Zero 


> A cool head as the 
Lasers rain down 
on you 
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Let's get stuck in 

If you have read the previous tutorials, 
you will know how we set up a basic Pygame Zero 
program, so we can jump right in to getting things 
on the screen. We will need some graphics for the 
various elements of the game - you can design them 
yourself or use ours from: magpi.cc/pgzer04. The 
Pygame Zero default screen size is 800 width by 600 
height, which is a good size for this game, so we 
don’t need to define WIDTH or HEIGHT. 


A bit of a player 

Let’s start with getting the player ship on 
the screen. If we call our graphic player.png, then 
we can create the player Actor near the top of 
our code by writing player = Actor("player", 
(400, 550)). 

We will probably want something a bit more 
interesting than just a plain black window, so we 
can add a background in our draw( ) function. If we 
draw this first, everything else that we draw will 
be on top of it. We can draw it using the blit () 
function by writing screen. blit( 1 background 1 , 
(0, 0)) - assuming we have called our background 
image background.png. Then, to draw the player, 
just add player. draw( ) afterwards. 


Let's get moving 

We need the player ship to respond to key 
presses, so we’ll check the Pygame Zero keyboard 
object to see if certain keys are currently pressed. 
Let’s make a new function to deal with these 
inputs. We will call the function checkKeys () and 
we’ll need to call it from our update () function. 

In the checkKeys () function, we write if 
keyboard. left : and then if player.x > 40: 
player.x -= 5. We need to declare the player 
Actor object as global inside our checkKeys () 
function. We then write a similar piece of code to 
deal with the right arrow key; figurei.py shows 
how this all fits together. 


An alien concept 

We now want to create a load of aliens 
in formation. You can have them in whatever 
format you want, but we’ll set up three rows of 
aliens with six on each row. We have an image 
called alien.png and can make an Actor for each 


figurei.py 


001 . 

002 . 

003. 

004. 

005. 

006. 

007. 

008. 

009. 

010 . 

011 . 

012 . 

013. 

014. 

015. 

016. 

017. 

018. 

019. 


import pgzrun 

player = Actor( "player", (400, 550)) # Load in the player 
Actor image 

def draw(): # Pygame Zero draw function 
screen. blit( ’background 1 , (0, 0)) 
player. draw() 

def updateQ: # Pygame Zero update function 

checkKeysQ 

def checkKeysQ : 

global player 
if keyboard.left: 

if player.x > 40: player.x -= 5 
if keyboard.right: 

if player.x < 760: player.x += 5 

pgzrun. go() 


▲ Functions to create 
a player ship and 

alien that we will store in a list so that we can background, display 

them, and handle 

easily loop through the list to perform actions moving the player ship 

on them. When we create the alien Actors, we 

will use a bit of maths to set the initial x and y 

coordinates. It would be a good idea to define 

a function to set up the aliens - initAliensQ 

- and because we will want to set up other 

elements too, we could define a function initQ, 

from which we can call all the setup functions. 


Doing the maths 

To position our aliens and to create them as 
Actors, we can declare a list - aliens = []-and 
then create a loop using for a in range(18) :. In 
this loop, we need to create each Actor and then 
work out where their x and y coordinates will be 
to start. We can do this in the loop by writing: 
aliens.append(Actor("alienl", (210+(a % 

6)*80,100+(int(a/6)*64) ))). This may look 
a little daunting, but we can break it down by 
saying ( x is 210 plus the remainder of dividing 
by 6 multiplied by 80’. 

This will provide us with x coordinates starting 
at 210 and with a spacing of 80 between each. The 
y calculation is similar, but we use normal division, 
make it an integer, and multiply by 64. 
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figure2.py 


001. def updateAliensQ : 

002. global moveSequence, moveDelay 

003. movex = movey = 0 

004. if moveSequence < 10 on moveSequence > 30: movex = -15 

005. if moveSequence == 10 on moveSequence == 30: 

006. movey = 50 

007. if moveSequence >10 and moveSequence < 30: movex = 15 

008. fon a in nange(len(aliens) ): 

009. animate(aliens[a] , pos=(aliens [a].x + movex, 

aliens[a].y + movey), dunation=0. 5, tween= linear' ) 

010 . if nandint(0, 1) == 0: 

011. aliens[a].image = "alienl" 

012. else: 

013. aliens[a].image = "alienlb" 

014. moveSequence +=1 

015. if moveSequence == 40: moveSequence = 0 


▲ The updateAliensQ 

function. Calculate 
the movement for the 
aliens based on the 
variable moveSequence 


Top Tip A 


Beware 
of deleting 
elements 
of a list 


If you delete 
a list element 
while you are 
looping through 
it with range 
(len(list)), 
when you get to 
the end of the 
loop it will run out 
of elements and 
return an error 
because the range 
of the loop is the 
original length of 
the list. 


Believing the strangest things 

After that slightly obscure title reference, 
we shall introduce the idea of the alien having a 
status. As we have seen in previous instalments, 
we can add extra data to our Actors, and in this case 
we will want to add a status variable to the alien 
after we have created it. We’ll explain how we are 
going to use this a bit later. Now it’s time to get 
the little guys on the screen and ready for action. 
We can write a simple function called dnawAlien () 
and just loop through the alien list to draw them 
by writing: for a in range(len(aliens)): 
aliens [a] .draw() . Call the drawAlienQ function 
inside the draw() function. 


The aliens are coming! 

We are going to create a function that 
we call inside our update () function that keeps 
track of what should happen to the aliens. We’ll 
call it updateAliens (). We don’t want to move 
the aliens every time the update cycle runs, so 
we’ll keep a counter called moveCounter and 
increment it each update (); then, if it gets to a 
certain value (moveDelay), we will zero the counter. 
If the counter is zero, we call updateAliens (). 

The updateAliens () function will calculate how 
much they need to move in the x and y directions to 
get them to go backwards and forwards across the 
screen and move down when they reach the edges. 


Updating the aliens 

To work out where the aliens should move, 
we’ll make a counter loop from o to 40. From 0 to 
9 we’ll move the aliens left, on 10 we’ll move them 
down, then from 11 to 29 move them right. On 30 
they move down and then from 31 to 40 move left. 
Have a look at figure2.py to see how we can do 
this in the updateAliens () function and how that 
function fits into our update () function. Notice how 
we can use the Pygame Zero function animate() 
to get them to move smoothly. We can also add a 
switch between images to make their legs move. 


All your base are belong to us 

Now we are going to build our defence 
bases. There are a few problems to overcome in 
that we want to construct our bases from Actors, 
but there are no methods for clipping an Actor 
when it is displayed. Clipping is a term to describe 
that we only display a part of the image. This is a 
method we need if we are going to make the bases 
shrink as they are hit by alien lasers. What we will 
have to do is add a function to the Actor, just like 
we have added extra variables to them before. 


Build base 

We will make three bases which will be 
made of three Actors each. If we wanted to display 
the whole image (basei.png), we would create 
a list of base Actors and display each Actor with 
some code like bases [0] .dnaw(). What we want to 
do is add a variable to the base to show how high 
we want it to be. We will also need to write a new 
function to draw the base according to the height 
variable. Have a look at figure3.py to see how we 
write the new function and attach it to each Actor. 
This means we can now call this function from 
each base Actor using: bases[b]. dnawClipped(), 
as shown in the drawBasesQ function. 


Can I shoot something now? 

To make this into a shooting game, let’s add 
some lasers. We need to fire lasers from the player 
ship and also from the aliens, but we are going to 
keep them all in the same list. When we create a 
new laser by making an Actor and adding it to the 
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list lasers [ ], we can give the Actor a type. In this 
case we’ll make alien lasers type o and player lasers 
type l. We’ll also need to add a status variable. 

The creation and updating of the lasers is similar 
to other elements we’ve looked at; figure4.py 
(overleaf) shows the functions that we can use. 


Making the lasers work 

You can see in figure4.py that we can create 
a laser from the player by adding a check for the 
SPACE key being pressed in our checkKeys () 
function. We will use the blue laser image called 
laser2.png. Once the new laser is in our list of 
lasers, it will be drawn to the screen if we call the 
drawLasersQ function inside ourdrawQ function. 
In our updateLasers () function we loop through 
the list of lasers and check which type it is. So if it is 
type l (player), we move the laser up the screen and 
then check to see if it hit anything. Notice the calls 
to a listCleanup( ) function at the bottom. We will 
come to this in a bit. 


figure3.py 


001. def drawClipped(self ): 

002. screen.surface. blit (self ._surf, (self.x-32, self.y- 

self .height+30), (0,0, 64, self .height)) 

003. 

004. def initBasesQ: 

005. global bases 

006. bases = [] 

007. be = 0 

008. for b in range(3): 

009. for p in range(3): 

010 . bases .append ( Actor ("basel", 

midbottom=(150+(b*200)+(p*40) , 520) )) 

011. bases[bc].drawClipped = drawClipped. get 

(bases[bc]) 

012 . bases[bc].height = 60 

013. be +=1 

014. 

015. def drawBasesQ : 

016. for b in range(len(bases) ): bases[b]. drawClippedQ 



Collision course 

Let’s look at checkPlayerLaserHitQ first. 


We can detect if the laser has hit any aliens by 


looping round the alien list and checking with the 
Actor function - collidepoint( (lasers[l] .x. 


lasers [1] .y)) - to see if a collision has occurred. 

If an alien has been hit, this is where our status 
variables come into play. Rather than just removing 
the laser and the alien from their lists, we need to 
flag them as ready to remove. The reason for this is 
that if we remove anything from a list while we are 


▲ Setting up an 
extension function 
to draw an Actor 
with clipping 



updateO 


imt() 


drawl) 
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Top Tip 4 


Write functions 
for each 
collective 
action 


To make coding 
easier to read 
rather than 
having Lots of 
code associated 
with one type 
of element 
in the dnaw() 
or update() 
functions, send it 
out to a function 
Like dnawLasers() 
or checkKeysQ. 
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figure4.py 

001 . 

def checkKeysQ : 

002 . 

global player, lasers 

003. 

if keyboard.space: 

004. 

1 = len(lasers) 

005. 

lasers .append(Actor ( "laser 2", 


(player.x,player.y- 32) )) 

006. 

lasers[l].status = 0 

007. 

lasers[l].type = 1 

008. 


009. 

def drawLasers( ): 

010 . 

for 1 in range(len(lasers) ) : lasers[ 1 ] .draw( ) 

011 . 


012 . 

def updateLasersQ : 

013. 

global lasers, aliens 

014. 

for 1 in range(len(lasers) ) : 

015. 

if lasers[l].type == 0 : 

016. 

lasers[l].y += (2*DIFFICULTY) 

017. 

checkLaserHit(l) 

018. 

if lasers[l].y > 600: lasers[l].status = 1 

019. 

if lasers[l].type == 1 : 

020 . 

lasers[l].y -= 5 

021 . 

checkPlayerLaserFlit(l) 

022 . 

if lasers[l].y < 10 : lasers[l].status = 1 

023. 

lasers = listCleanup(lasers) 

024. 

aliens = listCleanup(aliens) 


▲ Checking the keys 
that are pressed, 
creating lasers, 
moving them, and 
checking if they have 
collided with anything 


looping through any of the lists then by the time we 
get to the end of the list, we are an element short 
and an error will be created. So we set these Actors 
to be removed with status and then remove them 
afterwards with listCleanupQ. 


Covering the bases 

So far, we haven’t looked at what happens 
when a laser hits one of the defence bases. Because 
we are changing the height of the base Actors, 
the built-in collision detection won’t give us the 
result we want, so we need to write another custom 
function to check laser collision on the base Actor. 
Our new function, collideLaser () will check the 
laser coordinates against the base’s coordinates, 
taking into account the height of the base. We then 
attach the new function to our base Actor when 
it is created. We can use the new collideLaser () 
function for checking both the player and the alien 
lasers and remove the laser if it hits - and if it is 
an alien laser, reduce the height of the base that 
was hit. 


Laser overkill 

We may want to change the number of lasers 
being fired by the aliens, but at the moment our 
player ship gets to fire a laser every update () cycle. 
If the SPACE key is held down, a constant stream 
of lasers will be fired, which not only is a little bit 
unfair on the poor aliens but will also take its toll 
on the speed of the game. So we need to put some 
limits on the firing speed and we can do this with 
another built-in Pygame Zero object: the clock. If 
we add a variable laserActive to our player Actor 
and set it to zero when it fires, we can then call 
clock.schedule(makeLaserActive, 1.0) to call 
the function makeLaserActive( ) after l second. 


Top Tip 


Collect all your 
setup code in 
one place 


If possible, it is 
good to have 
as much of the 
code that sets 
everything back 
to the beginning 
in one place so 
that you can easily 
restart the game. 


Cleaning up the mess 

The listCleanupQ function creates a 
new empty list, then runs through the list that is 
passed to it, only transferring items to the new 
list that have a status of o. This new list is then 
returned back and used as the list going forward. 
Now that we have made a system for one type of 
laser we can easily adapt that for our alien laser 
type. We can create the alien lasers in the same 
way as the player lasers, but instead of waiting 
for a keyboard press we can just produce them at 
random intervals using if randint(0, 5) == 0: 
when we are updating our aliens. We set the type to 
o rather than l and move them down the screen in 
our updateLasersQ function. 


I r m hit! I'm hit! 

We need to look now at what happens 
when the player ship is hit by a laser. For this we 
will make a multi-frame animation. We have five 
explosion images to put into a list, with our normal 
ship image at the beginning, and attach it to our 
player Actor. We need to import the Math module, 
then in each draw( ) cycle we write: player. image 
= player. images [math, floor (player. status/6) ], 
which will display the normal ship image while 
player. status is o. If we set it to l when the player 
ship is hit, we can start the animation in motion. 

In the update () function we write: if player. 
status > 0 : player. status += 1 . As the status 
value increases, it will start to draw the sequence 
of frames one after the other. 
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Initialisation 

Now, it may seem a bit strange to be dealing 
with initialisation near the end of the tutorial, but 
we have been adding and changing the structure of 
our game elements as we have gone along and only 
now can we really see all the data that we need to 
set up before the game starts. In Step 04 we created 
a function called init () that we should call to get 
the game started. We could also use this function 
to reset everything back to start the game again. 

If we have included all the initialisation functions 
and variables we have talked about, we should have 
something like figures.py. 


figure5.py 


001 . def init() : 

002. global lasers, score, player, moveSequence, 

moveCounter, moveDelay 
003. initAliensQ 

004. initBasesQ 

005. moveCounter = moveSequence = player.status = score = 

player.laserCountdown = 0 
006. lasers = [] 

007. moveDelay = 30 

008. player.images = [ player","explosionl","explosion 2 ", 

"explosion3","explosion4","explosion5" ] 

009. player.laserActive = 1 


They're coming in too fast! 

There are a few finishing touches to do to 
complete this first part. We can set a DIFFICULTY 
value near the top of the code and use it on various 
elements to make the game harder. We should also 
add a score, which we do by adding 1000 to a global 
variable score if an alien is hit, and then display 
that in the top right of the screen in the draw() 


function. When the game finishes (the player 
has been hit or all the aliens are gone), we should 
display a suitable message. Have a look at the 
complete listing to see how these bits fit in. When 
that’s all done, we should have the basis of a Space 
Invaders game. In the next part, we will add more 
into the game, such as levels, lives, sound, bonus 
aliens, and a leaderboard. ED 


▲ The initialisation of 
our data. Calling this 
function sets our 
variables back to their 
start values 



4 It’s game over for now, 
but we’LL be back in 
the second part to 
improve the game 


Top Tip 4 


Define several 
variables at 
once 


If you are setting 
several variables 
to the same value, 
you can combine 
them into one line 
by writing a = b = 
c = 0 to set a, b, 
and c to zero. 


Retro Gaming with Raspberry Pi | 71 





























TUTORIAL 


pivadersl.py 


001. 

import pgzrun 

042. 


002. 

from random import randint 

043. def 

checkKeysQ : 

003. 

import math 

044. 

global player, lasers 

004. 

DIFFICULTY = 1 

045. 

if keyboard.left: 

005. 

player = Actor("player" , (400, 550)) # Load in the 

046. 

if player.x > 40: player.x -= 5 


player Actor image 

047. 

if keyboard.right: 

006. 


048. 

if player.x < 760: player.x += 5 

007. 

def drawQ: # Pygame Zero draw function 

049. 

if keyboard.space: 

008. 

screen. blit( 'background' , (0, 0)) 

050. 

if player.laserActive == 1: 

009. 

player.image = 

051. 

player.laserActive = 0 


player.images[math. floor (player.status/6)] 

052. 

clock. schedule(makeLaserActive, 1.0) 

010. 

player. drawQ 

053. 

1 = len(lasers) 

011. 

drawLasersQ 

054. 

lasers. append (Actor ("laser2". 

012. 

drawAliensQ 

(player.x,player.y-32))) 

013. 

drawBasesQ 

055. 

lasers[l].status = 0 

014. 

screen.draw. text (str( score), topright= 

056. 

lasers[l].type = 1 


(780, 10), owidth=0. 5, ocolor=(255, 255,255) , 

057. 



color=(0,64,255), fontsize=60) 

058. def 

makeLaserActiveQ : 

015. 

if player.status >= 30: 

059. 

global player 

016. 

screen.draw. text("GAME OVER\nPress Enter 

060. 

player.laserActive = 1 


to play again" , center=(400, 300), 

061. 



owidth=0. 5, ocolor=(255, 255,255) , 

062. def 

checkBasesQ : 


color=(255,64,0), fontsize=60) 

063. 

for b in range(len(bases) ): 

017. 

if len(aliens) == 0 : 

064. 

if 1 < len(bases): 

018. 

screen.draw. text ( YOU WON!\nPress Enter 

065. 

if bases[b].height < 5: 


to play again" , center=(400, 300), owidth=0.5. 

066. 

del bases[b] 


ocolor=(255,255,255) , color=(255,64,0) , 

067. 



fontsize=60) 

068. def 

updateLasersQ : 

019. 


069. 

global lasers, aliens 

020. 

def updateQ: # Pygame Zero update function 

070. 

for 1 in range(len(lasers)) : 

021. 

global moveCounter,player 

071. 

if lasers[l].type == 0: 

022. 

if player.status < 30 and len(aliens) > 0: 

072. 

lasers[l].y += (2*DIFFICULTY) 

023. 

checkKeysQ 

073. 

checkLaserHit(l) 

024. 

updateLasersQ 

074. 

if lasers[l].y > 600: 

025. 

moveCounter += 1 

075. 

lasers[l].status = 1 

026. 

if moveCounter == moveDelay: 

076. 

if lasers[l].type == 1: 

027. 

moveCounter = 0 

077. 

lasers[l].y -= 5 

028. 

updateAliensQ 

078. 

checkPlayerLaserHit(l) 

029. 

if player.status > 0: player.status += 1 

079. 

if lasers[l].y < 10: 

030. 

else: 

080. 

lasers[l].status = 1 

031. 

if keyboard.RETURN: init() 

081. 

lasers = listCleanup(lasers) 

032. 


082. 

aliens = listCleanup(aliens) 

033. 

def drawAliensQ : 

083. 


034. 

for a in range(len(aliens) ): aliens[a] .drawQ 

084. def 

listCleanup(l) : 

035. 


085. 

newList = [] 

036. 

def drawBasesQ : 

086. 

for i in range(len(l) ): 

037. 

for b in range(len(bases) ): 

087. 

if 1[i].status == 0: newList .append(l[i] ) 

038. 

bases[b] .drawClippedQ 

088. 

return newList 

039. 


089. 


040. 

def drawLasersQ : 

090. def 

checkLaserHit(l) : 

041. 

for 1 in range(len(lasers)) : lasers[l] .drawQ 

091. 

global player 
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DOWNLOAD 

THE FULL CODE: 


magpi.cc/pgzero4 


092. 

if player. collidepoint((lasens[l] .x. 


moveCounter, moveDelay 


lasers[l].y)): 

138. 

initAliensQ 

093. 

player.status = 1 

139. 

initBasesQ 

094. 

lasers[l].status = 1 

140. 

moveCounter = moveSequence = player.status 

095. 

for b in range(len(bases) ): 


score = player.laserCountdown = 0 

096. 

if bases[b] .collideLaser (lasers[1]): 

141. 

lasers = [] 

097. 

bases[b].height -= 10 

142. 

moveDelay = 30 

098. 

lasers[l].status = 1 

143. 

player.images = 

099. 



["player", "explosionl","explosion2". 

100. 

def checkPlayerLaserHit(l) : 


"explosion3","explosion4","explosion5"] 

101. 

global score 

144. 

player.laserActive = 1 

102. 

for b in range(len(bases) ): 

145. 


103. 

if bases[b] .collideLaser(lasers[l] ): 

146. 

def initAliensQ : 

104. 

lasers[l].status = 1 

147. 

global aliens 

105. 

for a in range(len(aliens) ): 

148. 

aliens = [] 

106. 

if aliens[a] .collidepoint((lasers[l] .x. 

149. 

for a in range(18): 


lasers[l].y)): 

150. 

aliens. append (Actor ("alienl", (210+ 

107. 

lasers[l].status = 1 

151. 

(a % 6) *80, 100+(int(a/6)*64) ))) 

108. 

aliens[a].status = 1 

152. 

aliens[a].status = 0 

109. 

score += 1000 

153. 


110. 


154. 

def drawClipped(self ): 

111. 

def updateAliensQ : 

155. 

screen.surface. blit (self ._surf, (self .x- 32 

112. 

global moveSequence, lasers, moveDelay 


self .y- self .height+30), (0,0,64, self. height)) 

113. 

movex = movey = 0 

156. 


114. 

if moveSequence < 10 or moveSequence > 30: 

157. 

def collideLaser(self , other): 

115. 

movex = -15 

158. 

return ( 

116. 

if moveSequence == 10 or moveSequence == 30: 

159. 

self.x-20 < other. x+5 and 

117. 

movey = 50 + (10 * DIFFICULTY) 

160. 

self .y-self. height+30 < other.y and 

118. 

moveDelay -= 1 

161. 

self.x+32 > other. x+5 and 

119. 

if moveSequence >10 and moveSequence < 30: 

162. 

self .y-self .height+30 + self. height > 

120. 

movex = 15 


other.y 

121. 

for a in range(len(aliens) ): 

163. 

) 

122. 

animate(aliens[a] , pos=(aliens[a] .x + movex. 

164. 



aliens[a].y + movey), duration=0. 5, tween=' linear' ) 

165. 

def initBasesQ: 

123. 

if randint(0, 1 ) == 0: 

166. 

global bases 

124. 

aliens[a].image = "alienl" 

167. 

bases = [] 

125. 

else: 

168. 

be = 0 

126. 

aliens[a].image = "alienlb" 

169. 

for b in range(3) : 

127. 

if randint(0, 5) == 0: 

170. 

for p in range(3): 

128. 

lasers. append(Actor( laserl". 

171. 

bases. append(Actor("basel , 


(aliens[a].x,aliens[a].y))) 


midbottom=(150+(b*200)+(p*40) , 520) )) 

129. 

lasers[len(lasers)-l].status = 0 

172. 

bases[bc].drawClipped = 

130. 

lasers[len(lasers)-l].type = 0 


drawClipped. _get_ (bases[bc]) 

131. 

if aliens[a].y > 500 and player.status == 

173. 

bases[bc].collideLaser = 


0 : 


collideLaser. _get_ (bases[bc]) 

132. 

player.status = 1 

174. 

bases[bc].height = 60 

133. 

moveSequence +=1 

175. 

be +=1 

134. 

if moveSequence == 40: moveSequence = 0 

176. 


135. 


177. 

init() 

136. 

def init(): 

178. 

pgzrun.goQ 

137. 

global lasers, score, player, moveSequence, 
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You'll Need 

> An image 
manipulation 
program such 
as GIMP, or 
images from 
magpi.cc/pgzero5 

> The Latest version 
of Pygame Zero 

> The Audacity 
sound editor or 
similar or sounds 
available from 

magpi.cc/pgzero5 

> Speakers or 
headphones 


Pygame Zero 

PiVaders: part 2 

This arcade shooter may be the first computer game that springs to 
mind for a lot of people, Here in part two we will take our basic PiVaders 
game from part one and add all the extras 


I n part one, last issue, we set up the basics for 
our PiVaders single-screen shoot-’em-up with 
our player ship controlled by the keyboard, 
defence bases, the aliens moving backwards and 
forwards across the screen, and lasers flying 
everywhere. In this part we will add lives and 
levels to the game, introduce a bonus alien, code a 
leader board for high scores, and add some groovy 
sound effects. We may even get round to adding an 
introduction screen if we get time. We are going to 
start from where we left off in part one. If you don’t 
have the part one code and files, you can download 
them from GitHub at magpi.cc/pgzer04. 


You only live thrice 

It was a tradition with Space Invaders to be 
given three lives at the start of the game. We can 
easily set up a place to keep track of our player 
lives by writing player, lives = 3inourinit() 
function. While we are in the init() function, let’s 
add a player name variable with player. name = "" 
so that we can show names on our leader board, but 
we’ll come to that in a bit. To display the number of 
lives our player has, we can add drawLives () to our 
draw() function and then define our drawLives() 
function containing a loop which ‘blits’ life.png 
once for each life in the top left of the screen. 


Introduction screen 
with input field for 
player’s name 


The player has three lives 
at the start of the game 
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If the player shoots all the aliens, 
they move on to the next level 
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A bonus or ’boss’ alien 
appears from time to time 


Scores from previous 
games are listed on the 
leader-board screen 
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Life after death 

Now we have a counter for how many lives 
the player has, we will need to write some code to 
deal with what happens when a life is lost. In part 
one we ended the game when the player. status 
reached 30. In our update () function we already 
have a condition to check the player. status and 
if there are any aliens still alive. Where we have 
written if player. status == 30 : we can write 
player. lives -= 1 . We can also check to see if the 
player has run out of lives when we check to see if 
the RETURN (aka ENTER) key is pressed. 


Keep calm and carry on 

Once we have reduced player. lives by 
one and the player has pressed the RETURN key, 
all we need to do to set things back in motion is to 
set player. status = 0 . We may want to reset the 
laser list too, because if the player was hit by a flurry 
of lasers we may find that several lives are lost 
without giving the player a chance to get out of the 
way of subsequent lasers. We can do this by writing 
lasers = []. If the player has run out of lives at 
this point, we will send them off to the leader-board 
page. See figurei.py to examine the code for dealing 
with lives. 


On the level 

The idea of having levels is to start the game 
in an easy mode; then, when the player has shot all 
the aliens, we make a new level which is a bit harder 
than the last. In this case we are going to tweak a 
few variables to make each level more difficult. To 
start, we can set up a global variable level = 1 in 
ourinitQ function. Now we can use our level 
variable to alter things as we increase the value. 
Let's start by speeding up how quickly the aliens 
move down the screen as the level goes up. When 
we calculate the movey value in updateAliensQ, 
we can write movey = 40 + (5*level) on the 
condition that moveSequence is 10 or 30. 


On the up 

To go from one level to the next, the player 
will need to shoot all the aliens. We can tell if 
there are any aliens left if len(aliens) = 0 . So, 
with that in mind, we can put a condition in our 
draw() function with if len(aliens) == 0 : and 


figurei.py 


001 . 

def draw() 


002 . 

# additional drawing code 


003. 

drawLivesQ 


004. 

if player.status >= 30: 


005. 

if player.lives > 0: 


006. 

drawCentreText( 


007. 

"YOU WERE HIT!\nPress Enter to re-spawn") 
else: 


008. 

drawCentreText( 


009. 

010 . 

"GAME OVER!\nPress Enter to continue") 

def init(): 


011 . 

# additional player variables 


012 . 

player.lives = 3 


013. 

player.name = "" 


014. 

015. 

def drawLivesQ : 


016. 

for 1 in range(player .lives): 


017. 

screen. blit ("life" , (10+ (1*32) , 10) ) 


018. 

019. 

def updateQ : 


020 . 

# additional code for life handling 


021 . 

global player, lasers 


022 . 

if player.status < 30 and len(aliens) > 

0 : 

023. 

if player.status > 0: 


024. 

player.status += 1 


025. 

if player.status == 30: 


026. 

player.lives -= 1 


027. 

else: 


028. 

if keyboard.RETURN: 


029. 

if player.lives > 0: 


030. 

player.status = 0 


031. 

lasers = [] 


032. 

else: 


033. 

# go to the leader-board 


034. 

pass; 


035. 

036. 

def drawCentreText(t) : 


037. 

screen.draw. text (t , center=(400, 300), 

owidth=0. 5, 


ocolor=(255, 255,255) , color=(255,64,0) , fontsize=60) 


, , , , , , , ▲ Code to deal 

then draw text on the screen to say that the level with p[ ayer 

has been cleared. We can put the same condition Lives ' Notice the 

dnawCentneText() 

in the section of the update () function where function to short-cut 

we are waiting for RETURN to be pressed. When printing text to the 

r centre of the screen 

RETURN is pressed and the length of the aliens list 
is 0, we can add 1 to level and call initAliens () 
and initBases () to set things ready to start the 
new level. 
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figure2.py 


001 . 

002 . 

003. 

004. 

005. 

006. 

007. 

008. 

009. 

010 . 

011 . 

012 . 

013. 

014. 

015. 

016. 

017. 

018. 

019. 

020 . 

021 . 

022 . 


def updateBossQ : 

global boss, level, player, lasers 
if boss.active: 

boss.y += (0.3*level) 

if boss.direction == 0: boss.x -= (1* level) 
else: boss.x += (1* level) 
if boss.x < 100: boss.direction = 1 
if boss.x > 700: boss.direction = 0 
if boss.y > 500: 

sounds.explosion. play () 
player.status = 1 
boss.active = False 
if randint(0, 30) == 0: 

lasers. append(Actor( laserl", 

(boss.x,boss.y))) 

lasers[len(lasers)-1].status = 0 
lasers[len(lasers)-1].type = 0 

else: 

if randint(0, 800) == 0: 
boss.active = True 
boss.x = 800 
boss.y = 100 
boss.direction = 0 


▲ Code to update the 
boss or bonus alien. 
This code runs when 
the boss is active 
or uses random 
numbers to see if it's 
time to make it active 


Front and centre 

You may have noticed in figurei.py 
that we made a couple of calls to a function 
called d rawCent reText () which we have not 
yet discussed. All that this function does is to 
shorten the process of writing text to the centre 
of the screen. We assume that the text will be 
positioned at coordinates (400, 300) and will 
have a set of standard style settings and colours, 
and the function definition just contains one 
line: screen.draw.text(t , center=(400, 
300), owidth=0.5, ocolor=(255,255,255), 
color=(255,64,0), fontsize=60) - where t is 
passed into the function as a parameter. 


Flying like a boss 

To liven up our game a little bit, we are 
going to add in a bonus or boss alien. This could 
be triggered in various ways, but in this case we 
will start the boss activity with a random number. 
First we will need to create the boss actor. Because 
there will only ever be one boss alien on screen at 
any time, we can just use one actor created near 
the start of our code. In this case we don’t need to 



A Lasers can be very bad for your health. Best to avoid them 


give it coordinates as we will start the game with 
the boss actor not being drawn. We write boss = 
Actor("boss"). 


Keeping the boss in the loop 

We want to start the game with the boss 
not being displayed, so we can add to our init () 
function boss .active = False and then in our 
draw( ) function if boss.active: boss.drawQ, 
which will mean the boss will not be drawn until 
we make it active. In our update () function, along 
with our other functions to update elements, 
we can call updateBoss (). This function will 
update the coordinates of the boss actor if it is 
active or, if it is not, check to see if we need to 
start a new boss flying. See figure2.py for the 
updateBoss () function. 


□id you hoar that? 

You may have noticed that in figure 2 .py 
we have an element of Pygame Zero that we have 
not discussed yet, and that is sound. If we write 
sounds. explosion. play( ), then the sound file 
located at sounds/explosion.wav will be played. 
There are many free sound effects for games on the 
internet. If you use a downloaded WAV file, make 
sure that it is fairly small. You can edit WAV sound 
files with programs like Audacity. We can add 
sound code to other events in the program in the 
same way, like when a laser is fired. 


More about the boss 

Staying with figure2.py, note how we can 
use random numbers to decide when the boss 
becomes active and also when the boss fires 
a laser. You can change the parameters of the 
randint () function to alter the occurrence of these 
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events. You can also see that we have a simple path 
calculating system for the boss to make it move 
diagonally down the screen. We use the level 
variable to alter aspects of the movement. We treat 
the boss lasers in the same way as the normal alien 
lasers, but we need to have a check to see if the 
boss is hit by a player laser. We do this by adding a 
check to our checkPlayerLaserHit() function. 


Three strikes and you're out 

In the previous episode, the game ended if 
you were hit by a laser. In this version we have three 
chances before the game ends, and when it does, we 
want to display a high score table or leader board to 
be updated from one player to the next. There are a 
few considerations to think about here. We need a 
separate screen for our leader board; we need to get 
players to enter their name to put against each score 
and we will have to save the score information. 

In other programs in this series we have used the 
variable gameStatus to control different screens, 
so let’s bring that back for this program. 



Screen switching with 
gameStatus 


We will need three states for the gameStatus 
variable. If it is set to o then we should display an 
intro screen where we can get the player to type 
in their name. If it is set to l then we want to run 
code for playing the game. And if it is set to 2 then 
we display the leader-board page. Let’s first deal 
with the intro screen. Having set our variable to o 
at the top of the code, we need to add a condition to 
our draw() function: if gameStatus == 0:.Then, 
under that, use dnawCentneText() to show some 
intro text and display the player. name string. To 
start with, player. name will be blank. 


A name is just a name 

Now to respond to the player typing their 
name into the intro screen. We will write a very 
simple input routine and put it in the built-in 
Pygame Zero function on_key_down (). figure3.py 
shows how we do this. With this code, if the 
player presses a key, the name of the key is added 
to the player. name string unless the key is the 
BACKSPACE key, in which case we remove the last 
character. Notice the rather cunning way of doing 


figure3.py 

001. 

def on_key_down(key) : 

002. 

global player 

003. 

if gameStatus == 0 and key.name != "RETURN": 

004. 

if len(key .name) == 1: 

005. 

player.name += key.name 

006. 

else: 

007. 

if key.name == "BACKSPACE": 

008. 

player.name = player.name[: -1] 


that with player, name = player .name[:-1]. We 

also ignore the RETURN key, as we can deal with 
that in our update() function. 


Code for capturing 
keyboard input for 
the player to input 
their name on the 
introduction screen 


Game on 

When the player has entered their name 
on the intro screen, all we need to do is detect a 
press of the RETURN key in our update () function 
and we can switch to the game part. We can easily 
do this by just writing if gameStatus == 0: 
and then under that, if keyboard. RETURN and 
player, name != : gameStatus = 1 . We will 

also now need to put our main game update code 
under a condition, if gameStatus == 1:. We will 
also need to have the same condition in the draw() 
function. Once this is done, we have a system for 
switching from intro screen to game screen. 


Leader of the pack 

So now we come to our leader-board screen. 
It will be triggered when the player loses the third 
life. When that happens, we set gameStatus to 2 
and put a condition in our draw() and updateQ 
functions to react to that. When we switch to our 
leader board, we need to display the high score 
list - so, we can write in our draw() function: 
if gameStatus == 2: drawHighScore(). Going 
back to figurei.py, you’ll see that we left a section 
at the end commented out, ready for the leader 
board. We can now fill this in with some code. 


15 


If only I learned to read and write 

We are going to save all our scores in a 
file so that we can get them back each time the 
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figure4.py 


001 . 

002 . 

003. 

004. 

005. 

006. 

007. 

008. 

009. 

010 . 

011 . 

012 . 

013. 

014. 

015. 

016. 

017. 

018. 

019. 

020 . 

021 . 

022 . 

023. 

024. 

025. 


026. 

027. 

028. 


029. 

030. 


def readHighScoreQ : 

global highScore, score, player 

highScore = [] 

try: 

hsFile = open( "highscores.txt", "r") 
for line in hsFile: 

highScore. append (line. rstrip ()) 

except : 
pass 

highScore. append(str(score)+ " " + player.name) 
highScore. sort (key=natural_key, reverse=True) 

def natural_key(string_) : 

return [int(s) if s.isdigit() else s for s in 
re. split(r ' (\d+)' , string_)] 

def writeHighScoreQ : 
global highScore 

hsFile = open("highscores.txt", "w ) 
for line in highScore: 

hsFile. write(line + "\n") 

def drawHighScore( ): 
global highScore 
y = 0 

screen.draw. text("TOP SCORES", midtop=(400, 30), 
owidth=0. 5, ocolor=(255, 255, 255) , color=(0, 64, 255) , 
fontsize=60) 

for line in highScore: 
if y < 400: 

screen.draw. text(line, midtop=(400, 100+y), 
owidth=0. 5, ocolor=(0, 0,255), color=(255, 255,0) , 
fontsize=50) 

y += 50 

screen.draw. text("Press Escape to play again' , 
center=(400, 550), owidth=0.5, ocolor=(255, 255, 255) , 
color=(255, 64, 0) , fontsize=60) 



A ALL the aliens have been destroyed. It's time to move up a Level 


Functions need to function 

We have named three functions that 
need writing in the last couple of steps: 
drawHighScoreQ, readHighScore( ), and 
writeHighScoreQ.Have a look at figure4.py to see 
the code that we need in these functions. The file 
reading and writing are standard Python functions. 
When reading, we create a list of entries and 
add each line to a list. We then sort the list into 
highest-score-first order. When we write the file, 
we just write each list item to the file. To draw the 
leader board, we just run through the high-score 
list that we have sorted and draw the lines of text 
to the screen. 


Sort it out 

It’s worth mentioning the way we are 
sorting the high scores. In figure4.py we are 
adding a key sorting method to the list sorting 
function. We do this because the list is a string 
but we want to sort by the high score, which is 
numerical, so we break up the string and convert 
it to an integer and sort based on that value rather 
than the string. If we didn’t do this and sorted as 
a string then all the scores starting with 9 would 
come first, then all the 8s, then all the 7s and so 
on, with 9000 being shown before 80 000, which 
would be wrong. 


A Code for reading, 
writing, sorting, and 
drawing the high 
score Leader board 


game is played. We can use a simple text file for 
this. When a new score is available, we will have 
to read the old score list in, add our new score to 
the list, sort the scores into the correct order, and 
then save the scores back out to create an updated 
file. So, the code we need to write in our update() 
function will be to call a readHighScore() 
function, set our gameStatus to 2, and call a 
wniteHighScone( ) function. 


Well, that's all folks 

That’s about all we need for our Pygame 
Zero PiVaders game other than all the additions 
that you could make to it. For example, you could 
have different graphics for each row of aliens. 
We’re sure you can improve on the sounds that 
we have supplied, and there are many ways that 
the level variable can be worked into the code 
to make the different levels more difficult or 
more varied. EH 
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pivaders2.py 

DOWNLOAD 

THE FULL CODE: 


magpi.cc/pgzero5 


001 . 

import pgzrun, math., re, time 

039. 

if keyboard. RETURN and player.name != “”: 

002. 

from random import randint 


gameStatus = 1 

003. 

player = Actor (“player”., (400, 550)) 

040. 

if gameStatus == 1: 

004. 

boss = Actor(“boss”) 

041. 

if player.status < 30 and len(aliens) > 0: 

005. 

gameStatus = 0 

042. 

checkKeysQ 

006. 

highScore = [] 

043. 

updateLasersQ 

007. 


044. 

updateBossQ 

008. 

def draw(): # Pygame Zero draw function 

045. 

if moveCounter == 0: updateAliensQ 

009. 

screen. blit ( 'background' , (0, 0)) 

046. 

moveCounter += 1 

010. 

if gameStatus == 0: # display the title page 

047. 

if moveCounter == moveDelay: 

011. 

drawCentreText(“PIVADERS\n\n\nType your 


moveCounter = 0 


name then\npress Enter to start\n(arrow keys move. 

048. 

if player.status > 0: 


space to fire)”) 

049. 

player.status += 1 

012. 

screen.draw. text(player. name , 

050. 

if player.status == 30: 


center=(400, 500), owidth=0.5, ocolor=(255,0,0). 

051. 

player.lives -= 1 


color=(0,64,255) , fontsize=60) 

052. 

else: 

013. 

if gameStatus == 1: # playing the game 

053. 

if keyboard. RETURN: 

014. 

player.image = player.images[math. 

054. 

if player.lives > 0: 


floor(player . status/6)] 

055. 

player.status = 0 

015. 

player .draw() 

056. 

lasers = [] 

016. 

if boss.active: boss.drawQ 

057. 

if len(aliens) == 0: 

017. 

drawLasersQ 

058. 

level += 1 

018. 

drawAliensQ 

059. 

boss.active = False 

019. 

drawBasesQ 

060. 

initAliensQ 

020. 

screen.draw. text (str( score) 

061. 

initBasesQ 


, topright=(780, 10), owidth=0.5. 

062. 

else: 


ocolor=(255, 255,255) , color=(0, 64,255) , 

063. 

readHighScoreQ 


fontsize=60) 

064. 

gameStatus = 2 

021. 

screen.draw. text(“LEVEL “ + str(level) , 

065. 

writeHighScoreQ 


midtop=(400, 10), owidth=0. 5, ocolor=(255,255,255). 

066. 

if gameStatus == 2: 


color=(0, 64,255) , fontsize=60) 

067. 

if keyboard. ESCAPE : 

022. 

drawLives() 

068. 

initQ 

023. 

if player.status >= 30: 

069. 

gameStatus = 0 

024. 

if player.lives > 0: 

070. 


025. 

drawCentreText (“YOU WERE HIT!\ 

071. 

def on_key_down(key) : 


nPress Enter to re-spawn”) 

072. 

global player 

026. 

else: 

073. 

if gameStatus == 0 and key.name != “RETURN”: 

027. 

drawCentreText(“GAME OVER!\nPress 

074. 

if len(key .name) == 1: 


Enter to continue”) 

075. 

player.name += key.name 

028. 

if len(aliens) == 0 : 

076. 

else: 

029. 

drawCentreText(“LEVEL CLEARED!\nPress 

077. 

if key.name == “BACKSPACE”: 


Enter to go to the next level ) 

078. 

player.name = player.name[: -1] 

030. 

if gameStatus == 2: # game over show the 

079. 



leaderboard 

080. 

def readHighScoreQ : 

031. 

drawHighScoreQ 

081. 

global highScore, score, player 

032. 


082. 

highScore = [] 

033. 

def drawCentreText(t) : 

083. 

try: 

034. 

screen.draw. text(t , center=(400, 300), 

084. 

hsFile = open(“highscores .txt”, “r”) 


owidth=0. 5, ocolor=(255, 255, 255) , color=(255,64,0) 

085. 

for line in hsFile: 


, fontsize=60) 

086. 

highScore. append (line. rstripQ) 

035. 


087. 

except: 

036. 

def updateQ: # Pygame Zero update function 

088. 

pass 

037. 

global moveCounter, player, gameStatus, lasers. 

089. 

highScore. append(str(score)+ ! “ + player.name^ 


level, boss 

090. 

highScore.sort(key=natural_key, reverse=True) 

038. 

if gameStatus == 0: 

091. 
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092. 

def natural_key(string_) : 

140. 

global player 

093. 

return [int(s) if s.isdigitQ else s for s in 

141. 

player.laserActive = 1 


re.split(r J (\d+) J , string_)] 

142. 


094. 


143. def 

checkBasesQ : 

095. 

def writeHighScoreQ : 

144. 

for b in range(len(bases) ): 

096. 

global highScore 

145. 

if 1 < len(bases): 

097. 

hsFile = open (“highscores.txt”, "w”) 

146. 

if bases[b].height < 5: 

098. 

for line in highScore: 

147. 

del bases[b] 

099. 

hsFile. write(line + "\n”) 

148. 


100. 


149. def 

updateLasersQ : 

101. 

def drawHighScoreQ : 

150. 

global lasers, aliens 

102. 

global highScore 

151. 

for 1 in range(len(lasers)) : 

103. 

y = 0 

152. 

if lasers[l].type == 0: 

104. 

screen.draw. text ("TOP SCORES”, midtop=(400. 

153. 

lasers[l].y += 2 


30), owidth=0. 5, ocolor=(255, 255, 255) , 

154. 

checkLaserHit(l) 


color=(0,64, 255) , fontsize=60) 

155. 

if lasers[l].y > 600: lasers[l]. 

105. 

for line in highScore: 

status = 1 

106. 

if y < 400: 

156. 

if lasers[l].type == 1: 

107. 

screen.draw. text (line, midtop=(400. 

157. 

lasers[l].y -= 5 


100+y), owidth=0.5, ocolor=(0, 0,255), 

158. 

checkPlayerLaserHit(l) 


color=(255, 255,0) , fontsize=50) 

159. 

if lasers[l].y < 10: lasers[l].status 

108. 

y += 50 

= 1 


109. 

screen.draw. text(“Press Escape to play 

160. 

lasers = listCleanup(lasers) 


again” , center=(400, 550), owidth=0.5. 

161. 

aliens = listCleanup(aliens) 


ocolor=(255, 255,255) , color=(255,64,0) , 

162. 



fontsize=60) 

163. def 

listCleanup(l) : 

110. 


164. 

newList = [] 

111. 

def drawLives() : 

165. 

for i in range(len(l)) : 

112. 

for 1 in range(player .lives): screen. 

166. 

if 1[i].status == 0: newList .append(l[i] ) 


blit (“life”, (10+(1*32) , 10) ) 

167. 

return newList 

113. 


168. 


114. 

def drawAliens() : 

169. def 

checkLaserHit(l) : 

115. 

for a in range(len(aliens) ): aliens[a]. iraw() 

170. 

global player 

116. 


171. 

if player. collidepoint((lasers[l] .x. 

117. 

def drawBasesQ : 

lasers[l].y)): 

118. 

for b in range(len(bases) ): bases[b]. 

172. 

sounds.explosion. play( ) 


drawClipped() 

173. 

player.status = 1 

119. 


174. 

lasers[l].status = 1 

120. 

def drawLasersQ : 

175. 

for b in range(len(bases) ): 

121. 

for 1 in range(len(lasers)) : lasers[l]. iraw() 

176. 

if bases[b] .collideLaser( lasers[1]): 

122. 


177. 

bases[b].height -= 10 

123. 

def checkKeysQ: 

178. 

lasers[l].status = 1 

124. 

global player, score 

179. 


125. 

if keyboard.left: 

180. def 

checkPlayerLaserHit(l) : 

126. 

if player.x > 40: player.x -= 5 

181. 

global score, boss 

127. 

if keyboard.right: 

182. 

for b in range(len(bases) ): 

128. 

if player.x < 760: player.x += 5 

183. 

if bases[b] .collideLaser (lasers[1]): 

129. 

if keyboard.space: 

lasers[l].status = 1 

130. 

if player.laserActive == 1: 

184. 

for a in range(len(aliens) ): 

131. 

sounds.gun. play() 

185. 

if aliens[a]. :ollidepoint( (lasers[l].x. 

132. 

player.laserActive = 0 

lasers[l].y)): 

133. 

clock. schedule (makeLaserActive, 1.0) 

186. 

lasers[l].status = 1 

134. 

lasers .append(Actor( r laser2”. 

187. 

aliens[a].status = 1 


(player.x,player.y-32))) 

188. 

score += 1000 

135. 

lasers[ en(lasers) -1] .status = 0 

189. 

if boss.active: 

136. 

lasers[ en(lasers) -1] .type = 1 

190. 

if boss.collidepoint((lasers[l] .x. 

137. 

score -= 100 

lasers[l].y)): 

138. 


191. 

lasers[l].status = 1 

139. 

def makeLaserActiveQ : 

192. 

boss.active = 0 
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193. 

scone += 5000 

244. 

def init() : 

194. 


245. 

global lasers, score, player, moveSequence, 

195. 

def updateAliensQ : 


moveCounter, moveDelay, level, boss 

196. 

global moveSequence, lasers, moveDelay 

246. 

initAliensQ 

197. 

movex = movey = 0 

247. 

initBasesQ 

198. 

if moveSequence < 10 on moveSequence > 30: 

248. 

moveCounter = moveSequence = player.status = 


movex = -15 


score = player.laserCountdown = 0 

199. 

if moveSequence == 10 on moveSequence == 30: 

249. 

lasers = [] 

200. 

movey = 40 + (5*level) 

250. 

moveDelay = 30 

201. 

moveDelay -= 1 

251. 

boss.active = False 

202. 

if moveSequence >10 and moveSequence < 30: 

252. 

player.images = 


movex = 15 


["player”,”explosionl”,”explosion2”,”explosion3”. 

203. 

for a in nange(len(aliens) ): 


”explosion4”,”explosion5”] 

204. 

animate(aliens[a] , pos=(aliens[a] .x 

253. 

player.laserActive = 1 


+ movex, aliens[a].y + movey), dunation=0. 5, 

254. 

player.lives = 3 


tween= J linear-* ) 

255. 

player.name = "" 

205. 

if randint(0, 1) == 0: 

256. 

level = 1 

206. 

aliens[a].image = "alienl” 

257. 


207. 

else: 

258. 

def initAliensQ : 

208. 

aliens[a].image = “alienlb” 

259. 

global aliens, moveCounter, moveSequence 

209. 

if nandint(0, 5) == 0: 

260. 

aliens = [] 

210. 

lasers. append(Actor( r laserl”. 

261. 

moveCounter = moveSequence = 0 


(aliens[a].x,aliens[a].y))) 

262. 

for a in range(18): 

211. 

lasens[len(lasens)-l].status = 0 

263. 

aliens. append(Actor(“alienl”, (210+(a % 

212. 

lasers[ en(lasens) -1] .type = 0 


6) *80, 100+(int(a/6)*64) ))) 

213. 

sounds.laser. play() 

264. 

aliens[a].status = 0 

214. 

if aliens[a].y > 500 and player.status == 

265. 



0: 

266. 

def drawClipped(self ): 

215. 

sounds.explosion. play () 

267. 

screen.surface. blit (self ._surf, (self .x- 32, 

216. 

player.status = 1 


self .y- self .height+30), (0,0, 64, self .height)) 

217. 

player.lives = 1 

268. 


218. 

moveSequence +=1 

269. 

def collideLaser(self , other): 

219. 

if moveSequence == 40: moveSequence = 0 

270. 

return ( 

220. 


271. 

self.x-20 < other. x+5 and 

221. 

def updateBossQ : 

272. 

self.y-self. height+30 < other.y and 

222. 

global boss, level, player, lasers 

273. 

self.x+32 > other. x+5 and 

223. 

if boss.active: 

274. 

self.y-self .height+30 + self. height > 

224. 

boss.y += (0.3*level) 


other.y 

225. 

if boss.direction == 0: boss.x -= (1* 

275. 

) 


level) 

276. 


226. 

else: boss.x += (1* level) 

277. 

def initBasesQ: 

227. 

if boss.x < 100: boss.direction = 1 

278. 

global bases 

228. 

if boss.x > 700: boss.direction = 0 

279. 

bases = [] 

229. 

if boss.y > 500: 

280. 

be = 0 

230. 

sounds.explosion. play () 

281. 

for b in range(3) : 

231. 

player.status = 1 

282. 

for p in range(3) : 

232. 

boss.active = False 

283. 

bases. append(Actor( ff basel-”, 

233. 

if randint(0, 30) == 0: 


midbottom=(150+(b*200)+(p*40) , 520) )) 

234. 

lasers .append(Actor (“laserl”. 

284. 

bases[bc].drawClipped = drawClipped. 


(boss.x,boss.y))) 


get_ (bases[bc]) 

235. 

lasers[ ?n(lasers) -1] .status = 0 

285. 

bases[bc].collideLaser = 

236. 

lasers[ ?n(lasers) -1] .type = 0 


collideLaser. _get_ (bases[bc]) 

237. 

else: 

286. 

bases[bc].height = 60 

238. 

if randint(0, 800) == 0: 

287. 

be +=1 

239. 

boss.active = True 

288. 


240. 

boss.x = 800 

289. 

initQ 

241. 

boss.y = 100 

290. 

pgzrun.goQ 

242. 

boss.direction = 0 




243. 


Retro Gaming with Raspberry Pi | 81 




TUTORIAL 


You'll Need 

> Raspbian 

> An image 
manipulation 
program such as 
GIMP, or images 
available from 
magpi.cc/pgzero6 

> The Latest version 
of Pygame Zero 

> USB joystick or 
gamepad (optional) 


Pygame Zero 

Hungry Pi-Man 

Maze games have been popular since the 1980s, Here we will be 
using more advanced Python programming techniques to create our 
own addition to the genre 


T he concept of Hungry Pi-Man is quite simple. 
Pi-Man eats green dots (peas) in a maze to 
score points. Avoid the flames unless you 
have just eaten a power-up, in which case you 
can eat them. In this series we have gradually 
introduced new elements of Pygame Zero and also 
concepts around writing games. This is the first 
instalment in a two-part tutorial which will show 
you some more tricks to writing arcade games with 
Pygame Zero. We will also use some more advanced 
programming concepts to make our games even 
better. In this first part, we will put together the 
basics of the Hungry Pi-Man game and introduce 
the concept of adding extra Python modules to 
our program. 


Let's get stuck in 

As with the more recent episodes of this 
series, let’s jump straight in, assuming that 
we have our basic Pygame Zero setup done. 

Let’s set our window size to WIDTH = 600 and 
HEIGHT = 660. This will give us room for a roughly 
square maze and a header area for some game 
information. We can get our gameplay area set up 
straight away by blitting two graphics - ‘header’ 
and ‘colourmap’ - to 0,0 and 0,80 respectively in 
the draw() function. You can make these graphics 
yourself or you can use ours, which can be found 
at magpi.cc/pgzero6. 


It r s amazing 

Our maze for the game has a specific 
layout, but you can make your own design if you 
want. If you do make your own, you’ll also have 
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▲ Our hungry Pi-Man explores the maze, gobbling green peas 
while avoiding flames 


to create two more maps (we’ll come to those in 
a bit) which help with the running of the game. 

The main things about the map is that it has a 
central area where the flames start from and it 
doesn’t have any other closed-in areas that the 
flames are likely to get trapped in (they can be a bit 
stupid sometimes). 


Pie and peas 

Our next challenge is to get a player actor 
moving around the maze. To fit our Hungry Pi-Man 
theme, for this we will have a hungry pie that goes 
around eating green peas - yes, it’s a rather surreal 
idea, but no stranger than the themes of many 
1980s arcade games! 

We’ll need two frames for our character: one 
with the mouth open and one with it closed. We 
can create our player actor near the top of the code 
using player = Actor("piman_o" ). This will 
create the actor with the mouth-open graphic. 

We will then set the actor’s location in an init() 
function, as in previous programs. 
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Modulify to simplify 

We can get our player onto the play area by 
setting player .x = 290 and player .y = 570 in 
the init() function and then call player. draw() 
in the draw() function, but to move the player 
character we’ll need to get some input from the 
player. Previously we have used keyboard and 
mouse input, but this time we are going to have the 
option of joystick or gamepad input. Pygame Zero 
doesn’t currently directly support gamepads, but 
we are going to borrow a bit of the Pygame module 
to get this working. We are also going to make a 
separate Python module for our input. 


It's a joystick.init 

Setting up a new module is easy. All we need 
to do is make a new file, in this case gameinput.py, 
and in our main program at the top, write import 
gameinput. In this new file we can import the 
Pygame functions we need with from pygame 
import joystick, key and from pygame.locals 
import *. We can then initialise the Pygame 
joystick object (this also includes gamepads) by 
typing joystick. init (). We can find out how 
many joysticks or gamepads are connected by using 
joystick_count = joystick.get_count(). If we 
find any joysticks connected, we need to initialise 
them individually - see figurei.py. 



The maze is made of 
corridors and maze walls 


Flames move around the 
maze, looking for Pi-Man 


The player is represented 
by the Pi-Man character 
that moves around the 
maze, eating dots 


Checking the input 

We can now write a function in our 
gameinput module to check input from 
the player. If we define the function with 
def checklnput(p): we can get the x axis of a 
joystick using joyin .get_axis(0) and they axis 
by using joyin. get_axis(l). The numbers that 
are returned from these calls will be between -l 
and +1, with o being the central position. We can 
check to see if the values are over o.8 or under 
-0.8, as, depending on the device, we may not 
actually see -l or l being returned. You may like to 
test this with your gamepad or joystick to see what 
range of values are returned. 


Up, down, left, or right 

The variable p that we are passing into our 
checklnputQ function will be the player actor. We 


figurei.py 


001. # gameinput Module 

002 . 

003. from pygame import joystick, key 
004. from pygame.locals import * 

005. 

006. joystick. init () 

007. joystick_count = joystick. get_count( ) 
008. 

009. if (joystick_count > 0): 

010. joyin = joystick. loystick(0) 

011. joyin. init() 

012. # For the purposes of this tutorial 

013. # we are only going to use the first 

014. # joystick that is connected. 


Top Tip 4 

Modules 


Using separate 
modules means 
not only is your 
code easier 
to follow, but 
it’s easier for 
a team to 
work on. 
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figure2.py 


001 . 

002 . 

003. 

004. 

005. 

006. 

007. 

008. 

009. 

010 . 

011 . 

012 . 

013. 

014. 

015. 

016. 

017. 

018. 


def checklnput(p) : 

global joyin, joystick_count 
xaxis = yaxis = 0 
if joystick_count > 0: 

xaxis = joyin.get_axis(0) 
yaxis = joyin .get_axis(l) 
if key .get_pnessed( )[K_LEFT] on xaxis < -0.8: 
p.angle = 180 
p.movex = -20 

if key.get_pnessed( )[K_RIGHT] on xaxis > 0.8: 
p.angle = 0 
p.movex = 20 

if key.get_pnessed( )[K_UP] on yaxis < -0.8: 
p.angle = 90 
p.movey = -20 

if key.get_pnessed() [K_DOWN] on yaxis > 0.8: 
p.angle = 270 
p.movey = 20 


figure3.py 

001. 

# inside updateQ function 

002. 


003. 

if player.movex or player.movey: 

004. 

inputLocl<( ) 

005. 

animate(player, pos=(player .x + player. 


movex, player.y + player.movey), duration=l/SPEED, 
tween= 1 linear' , on_f inished=inputllnl_ock) 

006. 


007. 

# outside updateQ function 

008. 


009. 

def inputLockQ: 

010. 

global player 

011. 

player.inputActive = False 

012. 


013. 

def inputl)nLock( ): 

014. 

global player 

015. 

player.movex = player.movey = 0 

016. 

player.inputActive = True 



▲ You can plug a gamepad or joystick into one of the USB ports 
on your Raspberry Pi 


Get a move on! 

Now we have our input function set up, we 
can call it from the update() function. Because this 
function is in a different module, we need to prefix 
it with the module name. In the update() function 
we write gameinput .checklnput(playen). After 
this function has been called, if there has been any 
input, we should have some variables set in the 
player actor that we can use to move. We can say 
if player.movex or player.movey: and then use 
the animate () function to move by the amount 
specified in player. movex and player. movey. 


Hold your horses 

The way we have the code at the moment 
means that any time there is some input, we fire 
off a new animation. This will soon mean that 
layers of animation get called over the top of each 
other, but what we want is for the animation to run 
and then start looking for new input. To do this we 
need an input locking system. We can call an input 
lock function before the move and then wait for 
the animation to finish before unlocking to look for 
more input. Look at figure3.py to see how we can 
make this locking system. 


can test each of the directions of the joystick at the 
same time as the keyboard and then set the player 
angle (so that it points in the correct direction for 
movement) and also how much it needs to move. 
We’ll set these by saying (for example, if the left 
arrow is pressed or the joystick is moved to the 
left)if key.get_pressed()[K_LEFT] on xaxis < 
-0.8: and then p.angle = 180 and p.movex = -20 
See figure2.py for the full checklnput () function. 


You can't just move anywhere 

Now, here comes the interesting bit. We 
want our player actor to move around the maze, but 
at the moment it will go though the walls and even 
off the screen. We need to restrict the movement 
only to the corridors of the maze. There are several 
different ways we could do this, but for this game 
we’re going to have an image map marking the 
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areas that the player actor can move within. The 
map will be a black and white one, showing just the 
corridors as black and the walls as white. We will 
then look at the map in the direction we want to 
move and see if it is black; if it is, we can move. 


Testing the map 

To be able to test the colour of a part of an 
image, we need to borrow a few functions from 
Pygame again. We’ll also put our map functions 
in a separate module. So make a new Python file 
and call it gamemaps.py and in it we’ll write 
from pygame import image. Color. 

We must also load in our movement map, which 
we need to do in the Pygame way: moveimage = 
image.load('images/pimanmovemap.png'). Then 
all we need to do is write a function to check that 
the direction of the player is valid. See figure4.py 
for this function. 


Using the movemap 

To use this new module, we need to 
import gamemaps at the top of our main code 
file and then, before we animate the player (but 
after we have checked for input), we can call 
gamemaps. checkMovePoint(player),which will 
zero the movex and movey variables of the player 
if the move is not possible. So now we should find 
that the player actor can only move inside the 
corridors. We do have one special case that you 
may have noticed in figure4.py, and that is because 
there is one corridor where the player can move 
from one side of the screen to the other. 


You spin me round 

There is one more aspect to the movement 
of the player actor, and that is the animation. As 
Pi-Man moves, the mouth opens and shuts and 
points in the direction of the movement. The 
mouth opening and closing is easy enough: we 
have an image for open and one for closed and 
alternate between the two. For pointing in the 
correct direction, we can rotate the player actor. 
Unfortunately, this has a slight problem that 
Pi-Man will be upside-down when moving left. So 
we just need to have one version that is switched 
the other way round. See figures.py for a function 
that sorts out all of this. 


figure4.py 


001. # gamemaps module 

002. from pygame import image. Color 

003. moveimage = image.load(' images/pimanmovemap.png' ) 

004. 

005. def checkMovePoint(p) : 

006. global moveimage 

007. if p.x+p.movex < 0: p.x = p.x+600 

008. if p.x+p.movex > 600: p.x = p.x-600 

009. if moveimage. get_at ( (int (p.x+p.movex), int(p.y+p. 

movey-80))) != Color( 'black' ): 

010. p.movex = p.movey = 0 


figureS.py 


001 . 

002 . 

003. 

004. 

005. 

006. 

007. 

008. 

009. 

010 . 

011 . 

012 . 

013. 

014. 

015. 

016. 

017. 

018. 

019. 

020 . 

021 . 

022 . 

023. 


def getPlayerImage( ): 
global player 

# we need to import datetime at the top of our code 
dt = datetime. now() 

a = player.angle 

# this next line will give us a number between 

# 0 and 5 depending on the time and SPEED 

tc = dt .microsecond%(500000/SPEED)/(100000/SPEED) 
if tc > 2.5 and (player.movex != 0 or player.movey 
! = 0 ) : 

# this is for the closed mouth images 
if a != 180: 

player.image = "piman_c" 
else: 

# reverse image if facing left 
player.image = "piman_cr" 

else: 

# this is for the open mouth images 
if a != 180: 

player.image = "piman_o" 
else: 

player.image = "piman_or" 

# set the angle on the player actor 
player.angle = a 


Top Tip A 


Pygame 


Pygame Zero is based on Pygame, but if you want 
to use some of the Pygame functions, best to do it 
in a separate module to avoid confusion. 
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figure6.py 


001 . 

002 . 

003. 

004. 

005. 

006. 

007. 

008. 

009. 

010 . 

011 . 

012 . 

013. 

014. 

015. 

016. 

017. 

018. 

019. 

020 . 

021 . 

022 . 

023. 

024. 

025. 

026. 

027. 

028. 

029. 

030. 

031. 

032. 

033. 

034. 

035. 

036. 

037. 


# This goes in the main code file. 

def initDotsQ: 

global piDots 
piDots = [] 
a = x = 0 
while x < 30: 
y = 0 

while y < 29: 

if gamemaps. checkDotPoint(10+x*20, 10+y*20): 
piDots. append (Acton ("dot" , (10+x*20, 

90+y*20) )) 

piDots[a].status = 0 
a += 1 
y += 1 
x += 1 

# This goes in the gamemaps module file. 

dotimage = image. load (' images/pimandotmap.png' ) 

def checkDotPoint(x,y) : 
global dotimage 

if dotimage. get_at((int(x), int(y))) == 

Colon( black ): 

return True 
return False 

# This bit goes in the drawQ function. 

piDotsLeft = 0 
for a in range(len(piDots)) : 
if piDots[a].status == 0: 
piDots[a] .drawQ 
piDotsLeft += 1 

if piDots[a]. :ollidepoint( (player.Xj player.y)): 
piDots[a].status = 1 

# if there are no dots left, the player has won 
if piDotsLeft == 0: player.status = 2 


Spot on 

So when we have put in a call to 
get Player Image () just before we draw the player 
actor, we should have Pi-Man moving around, 
chomping and pointing in the correct direction. 
Now we need something to chomp. We are going 
to create a set of dots at even spacings along most 
of the corridors. An easy way to do this is to use 
a similar technique that we’re using for testing 
where the corridors are. If we make an image map 
of the places the dots need to go and loop over the 


whole map, only placing dots where it is black, we 
can get the desired effect. 


Tasty, tasty dots 

To get our dots doing their thing, we’ll need 
to code a few things. We need to initialise actors 
for each dot, we need to draw each dot, and if the 
player eats the dot, we need to stop drawing it; 
figure6.py shows how we can do each of these 
jobs. We need initDotsQ, we need to add another 
function to gamemaps.py to work out where 
to position the dots, and we need to add some 
drawing code to the draw() function. In addition 
to the code in figure6.py, we need to add a call to 
initDotsQ inourinitQ function. 


Avoid the flames 

Now that we have our Pi-Man happily 
munching green peas, we must introduce our 
villains to the mix. Four hot flames, each rendered 
in a different colour, roam the maze looking for 
Pi-Man, starting from an enclosure in the centre 
of the map. We can initialise each flame as an 
actor to appear at the centre of the maze and keep 
them in a list called flames [ ]. To start off with, 
we’ll just make them move around randomly. The 
way we can do this is to set a random direction 
(f lames [g]. dir) for each and then keep them 
moving until they hit a wall. 
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Random motion 

We can use the same system that we used to 
check player movement for the flames. Each time 
we move a flame - moveFlames() - we can get a list 
of which directions are available to it. If the current 
direction (f lames [g]. dir) is not available, then we 
randomly pick another direction until we find one 
that we can move in. We can also have a random 
occurrence of changing direction, just to make it a 
bit less predictable - and if the flames collide with 
each other, we could do the same. When we have 
moved the flames with the animateQ function, 
we get it to count how many flames have finished 
moving. When they are all done, we can call the 
moveFlamesQ function again. 


| Pygame Zero: Hungry Pi-Man 

















TUTORIAL 


TopTip 4 


Animations 


When using the animate() function, it is best to use 
the callback function to see when it has finished, as 
different systems may work at different speeds. 


Light a flame 

The last thing to do with our flames is to 
actually draw them to the screen. We can create 
a function called d nawFlames () where we loop 
through the four flames and draw them to the 
screen. One of the details of the original game 
was that the eyes of the flames would follow the 
player; we can do this by setting the flame image 
to reverse if the player is to the left of the flame. 

We have numbered images so that flame one is 
flamei.png and flame two is flame2.png, etc. Have 
a look at the full pimani.py program listing to see 
all the functions that make the flames work. 


Game over 

Of course, we need to deal with the end-of- 
the-game conditions and, as before, we can use 
a status variable. In this case we have previously 
set player, status = 2 if the player wins. We 
can check to see if a flame collides with the player 
and set player. status = 1 . Then we just need to 
display some text in the draw() function based on 
this variable. And that's it for part one. In the next 
part we'll be giving the flames more brains, adding 
levels, lives, and power-ups - and adding some 
sweet, soothing music and sound effects. EH 
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[gameinputpy 

> Language: Python 3 

001. 

# gameinput Module 

002. 


003. 

from pygame import joystick, key 

004. 

from pygame.locals import * 

005. 


006. 

joystick. init() 

007. 

joystick_count = joystick. get_count() 

008. 


009. 

if(joystick_count > 0): 

010. 

joyin = joystick. loystick(0) 

011. 

joyin. init() 

012. 


013. 

def checklnput(p) : 

014. 

global joyin, joystick_count 

015. 

xaxis = yaxis = 0 

016. 

if joystick_count > 0: 

017. 

xaxis = joyin. get_axis(0) 

018. 

yaxis = joyin. get_axis(l) 

019. 

if key.get_pressed()[K_LEFT] or xaxis < -0.8: 

020. 

p.angle = 180 

021. 

p.movex = -20 

022. 

if key .get_pressed() [K_RIGHT] or xaxis > 0.8: 

023. 

p.angle = 0 

024. 

p.movex = 20 

025. 

if key.get_pressed() [K_UP] or yaxis < -0.8: 

026. 

p.angle = 90 

027. 

p.movey = -20 

028. 

if key.get_pressed() [K_DOWN] or yaxis > 0.8: 

029. 

p.angle = 270 

030. 

p.movey = 20 


▼ Three maps are used: one 
which we see, one to check 
possibLe movements, and 
one to check where dots 
are to be placed 



Colour Map 


Movement Map 


Dot Location Map 
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gamemaps.py 


> Language: Python 3 


001. # gamemaps module 
002 . 

003. from pygame import image. Color 
004. moveimage = image. load (' images/ 
pimanmovemap.png' ) 

005. dotimage = image. load (' images/ 
pimandotmap.png' ) 

006. 

007. def checkMovePoint(p) : 

008. global moveimage 

009. if p.x+p.movex < 0: p.x = 

p.x+600 

010. if p.x+p.movex > 600: p.x = p.x- 
600 

011. if moveimage. get_at((int(p.x+p. 
movex), int(p.y+p.movey-80))) != 

Color(' black ): 

012. p.movex = p.movey = 0 

013. 

014. def checkDotPoint(x,y): 

015. global dotimage 

016. if dotimage.get_at((int(x), 

int(y))) == Color(' black' ): 

017. return True 

018. return False 

019. 

020. def getPossibleDirection(g) : 

021. global moveimage 

022. if g.x-20 < 0: 

023. g.x = g.x+600 

024. if g.x+20 > 600: 

025. g.x = g.x-600 

026. directions = [0,0, 0,0] 

027. if g.x+20 < 600: 

028. if moveimage. get_ 

at( (int(g.x+20), int(g.y-80))) == 
Color( black ): directions[0] = 1 
029. if g.x < 600 and g.x >= 0: 

030. if moveimage. get_ 

at( (int(g.x) , int(g.y-60))) == 

Color(' black ): directions[l] = 1 
031. if g.x-20 >= 0: 

032. if moveimage. get_ 

at ((int(g.x-20), int(g.y-80))) == 
Color(’ black ): directions[2] = 1 
033. if g.x < 600 and g.x >= 0: 

034. if moveimage. get_ 

at((int(g.x), int (g.y-100))) == 
Color(’ black ): directions[3] = 1 
035. return directions 


pimanl.py 

> Language: Python 3 


00i. 

002 . 

003. 

004. 

005. 

006. 

007. 

008. 

009. 

010 . 

011 . 

012 . 

013. 

014. 

015. 

016. 

017. 

018. 

019. 

020 . 

021 . 

022 . 

023. 

024. 

025. 

026. 

027. 


028. 


029. 

030. 

031. 

032. 

033. 

034. 

035. 

036. 

037. 

038. 

039. 

040. 

041. 

042. 

043. 


044. 

045. 


import pgzrun 

import gameinput 

import gamemaps 

from random import randint 

from datetime import datetime 

WIDTH = 600 

HEIGHT = 660 

player = Actor( piman_o‘ ) # Load in the player Actor image 
SPEED = 3 

def draw(): # Pygame Zero draw function 

global piDots, player 
screen. blit( 'header’ , (0, 0)) 
screen. blit( 'colourmap' , (0, 80)) 
piDotsLeft = 0 
for a in range(len(piDots) ): 
if piDots[a].status == 0: 
piDots[a] .draw() 
piDotsLeft += 1 

if piDots[a]. :ollidepoint((player.x, player.y)): 
piDots[a].status = 1 
if piDotsLeft == 0: player.status = 2 

drawFlamesQ 
getPlayerImage() 
player. draw() 

if player.status == 1: screen.draw. text( GAME OVER" 

, center=(300, 434), owidth=0.5, ocolor=(255,255,255), 
color=(255,64,0) , fontsize=40) 

if player.status == 2: screen.draw. text ("YOU WIN!" 

, center=(300, 434), owidth=0.5, ocolor=(255,255,255), 
color=( 255,64,0) , fontsize=40) 

def updateQ: # Pygame Zero update function 

global player, moveFlamesFlag, flames 
if player.status == 0: 

if moveFlamesFlag == 4: moveFlames() 
for g in range(len(flames)) : 

if flames[g] .collidepoint((player.x, player.y)): 
player.status = 1 
pass 

if player.inputActive: 

gameinput .checklnput( player) 
gamemaps. checkMovePoint (player) 
if player.movex or player.movey: 

inputLockQ 

animate(player, pos=(player .x + player.movex, 
player.y + player.movey), duration=l/SPEED, tween= 'linear' , 
on_f inished=inputUnLock) 

def init() : 
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DOWNLOAD 

THE FULL CODE: 



Q magpi.cc/pgzero6 



046. 

global player 


+ dmoves[flames[g].dir] [0]*20, flames[g].y + 

047. 

initDotsQ 


dmoves[flames[g].dir] [1]*20), duration=l/SPEED, 

048. 

initFlames() 


tween= 'linear' , on_finished=f lagMoveFlames) 

049. 

player.x = 290 

094. 



050. 

player.y = 570 

095. 

def 

flagMoveFlames (): 

051. 

player.status = 0 

096. 


global moveFlamesFlag 

052. 

inputllnLockQ 

097. 


moveFlamesFlag += 1 

053. 


098. 



054. 

def getPlayerlmageQ : 

099. 

def 

flameCollided(ga,gn) : 

055. 

global player 

100. 


for g in range(len(flames)) : 

056. 

dt = datetime. now() 

101. 


if flames[g] .colliderect(ga) and g != gn: 

057. 

a = player.angle 

102. 


return True 

058. 

tc = dt. microsecond%(500000/SPEED)/(100000/SPEED) 

103. 


return False 

059. 

if tc > 2.5 and (player.movex != 0 or player.movey 

104. 




!=0) : 

105. 

def 

initDotsQ : 

060. 

if a != 180: 

106. 


global piDots 

061. 

player.image = "piman_c" 

107. 


piDots = [] 

062. 

else: 

108. 


QJ 

II 

X 

II 

© 

063. 

player.image = "piman_cr" 

109. 


while x < 30: 

064. 

else: 

110. 


y = 0 

065. 

if a != 180: 

111. 


while y < 29: 

066. 

player.image = "piman_o" 

112. 


if gamemaps .checkDotPoint(10+x*20, 10+y*20) 

067. 

else: 

113. 


piDots. append(Actor("dot", (10+x*20, 

068. 

player.image = "piman_or" 


90+y*20) )) 

069. 

player.angle = a 

114. 


piDots[a].status = 0 

070. 


115. 


a += 1 

071. 

def drawFlamesQ : 

116. 


y += 1 

072. 

for g in range(len(flames)) : 

117. 


x += 1 

073. 

if flames[g].x > player.x: 

118. 



074. 

flames[g].image = "flame"+str(g+l)+"r" 

119. 

def 

initFlamesQ : 

075. 

else: 

120. 


global flames, moveFlamesFlag 

076. 

flames[g].image = "flame"+str(g+l) 

121. 


moveFlamesFlag = 4 

077. 

flames[g] .drawQ 

122. 


flames = [] 

078. 


123. 


g = 0 

079. 

def moveFlames() : 

124. 


while g < 4: 

080. 

global moveFlamesFlag 

125. 


flames. append(Actor ( "flame"+str (g+1) 

081. 

dmoves = [(1,0),(0,1),(-1,0),(0,-1)] 


,(270+(g*20), 370))) 

082. 

moveFlamesFlag = 0 

126. 


flames[g].dir = randint(0, 3) 

083. 

for g in range(len(f lames)) : 

127. 


g += 1 

084. 

dirs = gamemaps.getPossibleDirection(flames[g] ) 

128. 



085. 

if flameCollided (flames[g],g) and randint(0,3) 

129. 

def 

inputLockQ : 


== 0: flames[g].dir = 3 

130. 


global player 

086. 

if dirs[flames[g].dir] == 0 or randint (0,50) == 

131. 


player.inputActive = False 


0: 

132. 



087. 

d = -1 

133. 

def 

inputllnLockQ : 

088. 

while d == -1: 

134. 


global player 

089. 

rd = randint(0,3) 

135. 


player.movex = player.movey = 0 

090. 

if dirs[rd] == 1: 

136. 


player.inputActive = True 

091. 

d = rd 

137. 



092. 

flames[g].dir = d 

138. 

init() 

093. 

animate(flames[g], pos=(flames[g] .x 

139. 

pgzrun.goQ 
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You’ll Need 

> Raspbian 

> An image 
manipulation 
program such as 
GIMP, or images 
available from 
magpi.cc/pgzero7 

> The latest version 
of Pygame Zero 
( 1 . 2 ) 

> USB joystick or 
gamepad (optional) 

> Headphones 
or speakers 


Pygame Zero 

Hungry Pi-Man: 
part 2 

In part two of our tutorial, we add some groovy features to the 
basic game created last time, including better enemy Al, power- 
ups, levels, and sound 


Pi-Man gets points for eating dots, 
and flames after eating power-ups 


If all the dots are eaten, Pi-Man 
moves up a Level; he has three lives 
before the game is over 
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I n part one, we created a maze for our player to 
move around, and restricted movement to just 
the corridors. We provided some dots (green 
peas) to eat and some flames to avoid. In this 
part we are going to give the flames some more 
brains so that they are a bit more challenging to 
the player. We will also add the bonus power-ups 
which turn the flames into tasty edibles, give Pi- 
Man some extra levels to explore and some extra 
lives. So far in this series we have not dealt with 
music, so we will have a go at putting some music 
and sound effects into the game. 


Need more brains 

Also in part one, we left our flames 
wandering around the maze randomly without 
much thought for what they were doing, which was 
a bit unfair as Pi-Man could evade them without 
too much trouble. In the original game, each flame 
had a program that it followed to characterise its 
movements. We are going to add some brains to 
two of the flames. The first we will make follow 
Pi-Man, and the second we will get to ambush 
by moving ahead of Pi-Man. We will still leave in 
some random movement, otherwise it may get a 
bit too difficult. 


If Pi-Man eats a power-up, the 
flames turn dark and are edible 


Follow the leader 

First, let’s get the red flame to follow 
Pi-Man. We already have a moveFlames () function 
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T Adding a brain to 
a flame to foLLow 
the player 


from part one and we can add a condition to see 
if we are dealing with the first flame: if g == 0: 
followPlayer(g J dirs). This calls followPlayer() 
if it’s the first flame. The followPlayer () function 
receives a list of directions that the flame can 
move in. It then tests the x coordinate of the player 
against the x coordinate of the flame and, if the 
direction is valid, sets the flame direction to move 
toward the player. Then it does the same with 
they coordinates. 


Y over x 

The keen-witted among you will have 
noticed that if x and y movements towards the 
player are both valid, then the y direction will 
always win. We could throw in another random 
number to choose between the two, but in testing 
this arrangement it doesn’t cause any significant 
problem with the movement. See figurei.py for 
the followPlayer () function. You will see there is a 
special condition aboveCentre () when we check the 
downward movement. We are checking that the 
flame is not just above the centre, otherwise it will 
go back into its starting enclosure. 


03 


The central problem 

If we go back to the moveFlames () function, 
we need another centre-related condition: if 
inTheCentre(f lames [g] ). This is because if we leave 
the flame to randomly move around our centre 
enclosure, it may take a long time to get out. In 
part one, you may have noticed that from time 


figurei.py 


001. 

def followPlayer(g, dirs): 


002. 

d = flames[g].dir 


003. 

if d == 1 or d == 3: 


004. 

if player.x > flames[g].x and 

dirs[0] == 1: 

005. 

flames[g].dir = 0 


006. 

if player.x < flames[g].x and 

dirs[2] == 1: 

007. 

flames[g].dir = 2 


008. 

if d == 0 or d == 2: 


009. 

if player.y > flames[g].y and 

dirs[l] == 1 ■ 


aboveCentre (flames[g]): flames[g].dir 

= 1 

010. 

if player.y < flames[g].y and 

dirs[3] == 1: 

011. 

flames[g].dir = 3 


012. 



013. 



014. 

def aboveCentre(ga) : 


015. 

if ga.x > 220 and ga.x < 380 and ga.y > 300 and 


< 320: 


016. 

return True 


017. 

return False 



to time one flame would get stuck in the centre. 
What we do is, if we detect that a flame is in the 
centre, we always default to direction 3, which is 
up. If we run the game with this condition and 
the followPlayer () function, we should see all 
the flames making their way straight out of the 
centre and then the red flame making a bee-line 
towards Pi-Man. 
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figure2.py 


001. 

002. 

# 

This code goes in the updateQ function 

003. 


if player.status == 1: 

004. 


i = gameinput .checklnput(player) 

005. 


if i == 1: 

006. 


player.status = 0 

007. 


player.x = 290 

008. 

009. 


player.y = 570 

010. 

# 

This code goes in the gameinput module 

011. 

012. 

# 

in the checklnputQ function 

013. 


if joystick_count > 0: 

014. 


jb = joyin .get_button(l) 

015. 


else: 

016. 


jb = 0 

017. 


if p.status == 1: 

018. 


if key. get_pressed ()[K_RETURN] or 

019. 


return 1 


It's an ambush! 

So, the next brain to implant is for 
the second flame. We will add a function 
ambushPlayerQ in the same way we did for the first 
flame, but this time if g == 1: . The ambushPlayerQ 
function works very much like the followPlayer () 
function, but this time we just check the direction 
that Pi-Man is currently moving and try to move in 
that direction. We, of course, cannot know which 
direction the player is going to move, and this may 
seem a bit of a simplistic approach to ambushing 
the player, but it is surprising how many times 
Pi-Man ends up wedged between these two flames 
with this method. 


Scores on the doors 

Brain functions could be added to all the 
flames, but we are going to leave the flame brains 
for now as there is plenty more to do to get our 


A Checking to see if ENTER 
or button A has been 
pressed and resetting the 
player actor 

▼ Pi-Man gets three lives. 
You can use the gamepad 
or joystick buttons to ask 
for input from the player 
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game completed. Before we go any further, we 
ought to get a scoring system going and reward Pi- 
Man for all the dots eaten. We can attach the score 
variable to the player actor near the top of our code 
with player, score = 0 and then each time a dot 
is eaten we add 10 to the score with player. score 
+= 10. We can also display the score in the draw() 
function (probably top right is best) with screen. 
draw.text(). 


Three strikes and you're out! 

As is the tradition in arcade games, you 
get three lives before it’s game over. If you 
followed our previous tutorial for PiVaders, you 
will already know how we do this. We just add a 
lives variable to the player actor and then each 
time Pi-Man is caught by a flame, we take a life off, 
set player .status = 1 , and print a message to say 
press ENTER. When pressed, we set player. status 
= 0 and send Pi-Man back to the starting place. 
Then we continue. Have a look at figure 2 .py to see 
the code we add to reset Pi-Man to the start. 


Printing lives 

We have the system for keeping track of 
the player. lives variable, but we also need to 
show the player how many lives they have left. 

We can do this with a simple loop like we used 
in the previous PiVaders tutorial. We can have 
a drawLives () function which we call from our 
draw( ) function. In that function, we go round a 
loop for the number of lives we have by saying for 
1 in range(player .lives) : and then we can use 
the same image that we use for the player and say 
screen.blit("piman_o", (10+(1*32),40)). 


Which button to press 

You may notice in figure2.py that in our 
gameinput module we are checking a joystick 
button as well as the ENTER key. You may want to 
do a few tests with the gamepads or joysticks that 
you’re using, as the buttons may have different 
numbers. You can also prompt the player to press 
(in this case) the A button to continue. If you were 
designing a game that relied on several buttons 
being used, you might want to set up a way of 
mapping the buttons to values depending on what 
type of gamepad or joystick is being used. 


figure3.py 


001. # This code is in our main code file (piman2.py) 

002 . 

003. def initDotsQ: 

004. global piDots 

005. piDots = [] 

006. a = x = 0 

007. while x < 30: 

008. y = 0 

009. while y < 29: 

010. d = gamemaps.checkDotPoint(10+x*20, 10+y*20) 

011. if d == 1: 


012. 

piDots .append(Actor ( 

'dot",(10+x*20. 

90+y*20) )) 

013. 

piDots[a].status = 0 


014. 

piDots[a].type = 1 


015. 

QJ 

II 

l-> 


016. 

if d == 2: 


017. 

piDots. append(Actor ( 

’power" j (10+x*20j 

90+y*20) )) 

018. 

piDots[a].status = 0 


019. 

piDots[a].type = 2 


020. 

a += 1 



021. y += 1 

022. x += 1 

023. 

024. # This code is in the gamemaps module 
025. 

026. def checkDotPoint(x,y) : 

027. global dotimage 

028. if dotimage. get_at( (int(x) , int(y))) == 

Color( 1 black' ): 

029. return 1 

030. if dotimage. get_at ( (int(x) , int(y))) == Color( 'red' ): 

031. return 2 

032. return False 


▲ Updated code to 
incLude the creation 
of power-ups 


I have the power! 

The next item on our list is power-ups. 
These are large glowing dots that, when eaten, 
turn all the flames dark. In their dark form they 
can be eaten for bonus points and they return to 
the centre of the maze. First, let’s devise a way to 
place the power-ups in the maze. We have updated 
the pimandotmap.png image to include some red 
squares, instead of black, in the positions where we 
want our power-ups to be. Then, when we initialise 
our dots and call checkDotPoint (x , y ), we look for 
red as well as black - figures.py shows how we 
change our code to do this. 
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gamemaps.py 


> Language: Python 3 


001. from pygame import image, surface, Color 

002. moveimage = image. load (' images/pimanmovemap.png ) 

003. dotimage = image. load( 'images/pimandotmap.png' ) 

004. 

005. def checkMovePoint(p) : 

006. global moveimage 

007. if p.x+p.movex < 0: p.x = p.x+600 

008. if p.x+p.movex > 600: p.x = p.x- 600 

009. if moveimage. get_at((int( p.x+p.movex), int(p.y+ 

p.movey-80))) != Color( 'black'): 

010. p.movex = p.movey = 0 

011. 

012. def checkDotPoint(x,y) : 

013. global dotimage 

014. if dotimage. get_at( (int(x), int(y))) == 

Color( 'black' ): 

015. return 1 

016. if dotimage. get_at ((int(x), int(y))) == 

Color( 'red ): 

017. return 2 

018. return False 

019. 

020. def getPossibleDirection(g) : 

021. global moveimage 

022. if g.x-20 < 0: 

023. g.x = g.x+600 

024. if g.x+20 > 600: 

025. g.x = g.x -600 

026. directions = [0,0,0, 0] 

027. if g.x+20 < 600: 

028. if moveimage. get_at((int (g.x+20), 

int(g.y-80))) == Color (' black '): directions[0] = 1 
029. if g.x < 600 and g.x >= 0: 

030. if moveimage. get_at((int (g.x), int(g.y-60))) 

== Color( black ): directions[l] = 1 
031. if g.x-20 >= 0: 

032. if moveimage. get_at((int (g.x-20), 

int(g.y-80))) == Color( 'black '): directions[2] = 1 
033. if g.x < 600 and g.x >= 0: 

034. if moveimage. get_at((int (g.x), int (g.y-100) )) 

== Color( black ): directions[3] = 1 
035. return directions 


Not all dots are the same 

We now have a system to place our power- 
ups in the maze. The next thing to do is to change 
what happens when Pi-Man eats a power-up 
compared to a normal dot. At the moment we 
just add ten points to the player’s score if a dot is 
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▲ Pi-Man gets three Lives before it's game 
over. Change the player.lives = 3 
variable in the code to give your player 
more (or fewer) lives to play with. 


eaten, so we need to add more code to handle the 
event of a power-up being eaten. In the draw() 
function, where we look to see if the player has 
collided with a dot using collidepoint (), we then 
check the status of the dot (to make sure it’s still 
there) and after this we can add a new condition: 
if piDots[a].type == 2:. 


High status flames 

As we have determined that we are dealing 
with a power-up (type 2), we can add a loop that 
goes through the list of flames and changes the 
status of the flame. Normally the status for a flame 
is 0. What we are going to do is change the status 
to a fairly high number (try 1200 to start with). This 
will indicate that the flames are in their alternate 
state and we will use the status as a countdown. 

We will decrement this value each time update( ) is 
called; when it reaches 0, the flames will turn back 
to normal. 


Why so dark? 

To make our flame turn dark, we are going 
to add some conditions to our drawFlames() 
function. We want them to be dark when the status 
is more than 0, but just to make it interesting 
we will make them flash when they are about 
to turn back. So we can write if f lames [g]. 
status > 200 or (flames[g].status > 1 and 


flames[g].status%2 == 0): flames[g].image = 

"f lame"+str(g+l )+"-". What this is saying is that 
if the status is over 200 then make the flame dark, 
but if it’s less that 200 but greater than 1 then 
make it dark every other frame. We then have an 
else condition underneath that will set the image 
to its normal colour. 
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gameinput.py 

> Language: Python 3 


001. 

from pygame import joystick, key 

021. 

if key. get_pressed ()[K_RIGFIT] or xaxis >0.8 

002. 

from pygame.locals import * 

022. 

p.angle = 0 

003. 


023. 

p.movex = 20 

004. 

joystick. init() 

024. 

if key.get_pressed() [K_UP] or yaxis < -0.8: 

005. 

joystick_count = joystick. get_count() 

025. 

p.angle = 90 

006. 


026. 

p.movey = -20 

007. 

if (joystick_count > 0): 

027. 

if key.get_pressed() [K_DOWN] or yaxis > 0.8: 

008. 

joyin = joystick. loystick(0) 

028. 

p.angle = 270 

009. 

joyin.initQ 

029. 

p.movey = 20 

010. 


030. 

if joystick_count > 0: 

011. 

def checklnput(p) : 

031. 

jb = joyin. get_button(l) 

012. 

global joyin, joystick_count 

032. 

else: 

013. 

xaxis = yaxis = 0 

033. 

jb = 0 

014. 

if p.status == 0: 

034. 

if p.status == 1: 

015. 

if joystick_count > 0: 

035. 

if key .get_pressed() [K_RETURN] or jb: 

016. 

xaxis = joyin. get_axis(0) 

036. 

return 1 

017. 

yaxis = joyin. get_axis(l) 

037. 

if p.status == 2: 

018. 

if key.get_pressed() [K_LEFT] or xaxis < -0.8: 

038. 

if key .get_pressed() [K_RETURN] or jb: 

019. 

p.angle = 180 

039. 

return 1 

020. 

p.movex = -20 




The tables have turned 

Now we have our flames all turning dark 
when a power-up is eaten, we need to change what 
happens when Pi-Man collides with them. Instead 
of taking a life from the player. lives variable, we 
are going to add to the player. score variable and 
send the flame back to the centre. So, the first job 
is to add a condition in update () when we check the 
flame collidepoint( ) with the player, which would 
be if flames[g] . status > 0: . We then add 100 to 
the player, score and animate() the flame back to 
the centre. See figure4.py for the updated code. 


Back to the start 

You will notice that when Pi-Man comes 
into contact with a dark flame, we just animate 
the actor straight back to the centre in the same 
time that we normally animate a flame from one 
position to the next. This is so that we don’t hold 
up the animation on the other flames waiting 
for the eaten one to get back to the centre. In the 
original game, the flames would turn into a pair of 
eyes and then make their way back to the centre 
along the corridors, but that would take too much 
extra code for this tutorial. 
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figure4.py 


001 . 

002 . 

003. 

004. 

005. 

006. 

007. 

008. 


009. 

010 . 

011 . 

012 . 

013. 

014. 


# This code is in the updateQ function 

for g in range(len(flames) ): 

if flames[g].status > 0: flames[g].status -= 1 
if flames[g] .collidepoint( (player.x, 

player.y)): 

if flames[g].status > 0: 
player.score += 100 
animate(f lames[g], pos=(290, 370), 
duration=l/SPEED, tween= 'linear , 
on_finished=f lagMoveFlames) 
else: 

player.lives -= 1 
if player.lives == 0: 

player.status = 3 
else: 

player.status = 1 



Time for some music 

So far in this series, we have not covered 


adding music to games. In the documentation of 


Pygame Zero, music is labelled as experimental, 
so we will just have to try it out and see what 


Updated flame 
collision code to 
send them back to 
the centre if Pi-Man 
eats them 
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happens. In the sample GitHub files for this 
tutorial, there is a directory called music and 
in that directory is an MP3 file that we can use 
as eighties arcade game background music. 

To start our music, all we need to do is write 
music.play("pml") in our init() function to start 
the music/pmi.mp3 file. You may also want to set 
the volume with music. set_volume(0.3). 


More sound effects 

The MP3 file will continue playing in a 
loop until we stop it, so when the game is over 
(player, lives = 0) we can fade the music out with 
music . f adeout ( 3 ). At this stage we can also add 
some sound effects for when Pi-Man is eating dots. 
We have a sound in our sounds directory called 
pii.mp3 which we will use for this purpose and we 
can add a line of code just before we animate the 
player: sounds. pil. play (). This will play the sound 
every time Pi-Man moves. We can do the same 
with pi2.mp3 when a life is lost. 


Level it up 

The last thing we need to put into our 
game is to allow the player to progress to the next 
level when all the dots have been eaten. We could 
incorporate several things to make each level 
harder, but for the moment let’s concentrate on 
resetting the screen and changing the level. If we 
define our level variable near the top of our code 
as level = 0, then inside our init( ) function we 
say level += 1, then each time we call init() we 
will increase our level variable. This means that 
instead of saying that the player has won, we just 
prompt them to continue, and call initQ to reset 
everything and level up. 


So much to do 

The Pi-Man game has many more things 
that can be added to it. For instance, you could 
include bonus fruits to collect, the flames might 
move faster as the levels continue, there could be 
animations between some of the levels, and the 
power-ups might run out quicker. You could add 
all of these things to this game, but we will have to 
leave you to do that yourself. In the next tutorial, 
we’ll be starting a new Pygame Zero game with 
isometric 3D graphics. ED 
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piman2.py 


> Language: Python 3 


001. 

import pgzrun 


002. 

import gameinput 


003. 

import gamemaps 


004. 

from random import randint 


005. 

from datetime import datetime 


006. 

WIDTH = 600 


007. 

HEIGHT = 660 


008. 

009. 

player = Actor("piman_o") # Load in the player Actor image 


010. 

player.score = 0 


011. 

player.lives = 3 


012. 

level = 0 


013. 

SPEED = 3 


014. 

015. 

def draw(): # Pygame Zero draw function 


016. 

global piDots, player 


017. 

screen. blit( 'header' , (0, 0)) 


018. 

screen. blit( 'colourmap ', (0, 80)) 


019. 

piDotsLeft = 0 


020. 

for a in range(len(piDots) ) : 


021. 

if piDots[a].status == 0: 


022. 

piDots[a] .draw() 


023. 

piDotsLeft += 1 


024. 

if piDots[a] .collidepoint((player.x, player.y)): 


025. 

if piDots[a].status == 0: 


026. 

if piDots[a].type == 2: 


027. 

for g in range(len(flames)) : flames[g].status = 1200 

028. 

else: 


029. 

player.score += 10 


030. 

piDots[a].status = 1 


031. 

if piDotsLeft == 0: player.status = 2 


032. 

drawFlamesQ 


033. 

getPlayerImage() 


034. 

player ,draw() 


035. 

drawLivesQ 


036. 

screen .draw. text("LEVEL "+str(level) , topleft=(10, 10)., 

owidth=0.5. 

037. 

ocolor=(0, 0,255), color=(255, 255,0) , fontsize=40) 

screen.draw. text(str(player. score) , topright=(590, 20), 

owidth=0.5. 

038. 

ocolor=(255, 255,255) , color=(0, 64,255) , fontsize=60) 
if player.status == 3: drawCentreText("GAME OVER") 


039. 

if player.status == 2: drawCentreText( 


040. 

"LEVEL CLEARED! \nPress Enter or Button A\nto Continue") 
if player.status == 1: drawCentreText( 


041. 

042. 

"CAUGHT! \nPress Enter or Button A\nto Continue") 

def drawCentreText(t) : 


043. 

screen.draw. text(t , center=(300, 434), owidth=0.5. 


044. 

045. 

ocolor=(255, 255,255) , color=(255,64,0) , fontsize=60) 

def updateQ: # Pygame Zero update function 


046. 

global player, moveFlamesFlag, flames 
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DOWNLOAD 

THE FULL CODE: 



0 magpi.cc/pgzero7 



047. 

if player.status == 0: 

093. 

def drawLivesQ: 

048. 

if moveFlamesFlag == 4: moveFlamesQ 

094. 

for 1 in range(player.lives) : screen. blit("piman_o". 

049. 

for g in range(len(flames)) : 


(10+(1*32),40) ) 

050. 

if flames[g].status > 0: flames[g].status -= 1 

095. 


051. 

if flames[g]. collidepoint( (player.x. 

096. 

def getPlayerlmageQ : 


player.y)): 

097. 

global player 

052. 

if flames[g].status > 0: 

098. 

dt = datetime. now() 

053. 

player.score += 100 

099. 

a = player.angle 

054. 

animate(flames[g], pos=(290, 370), 

100. 

tc = dt .microsecond%(500000/SPEED)/(100000/SPEED) 


duration=l/SPEED, tween= 'linear' , 
on_finished=flagMoveFlames) 

101. 

if tc > 2.5 and (player.movex != 0 or player.movey 
! =0) : 

055. 

else: 

102. 

if a != 180: 

056. 

player.lives -= 1 

103. 

player.image = "piman_c" 

057. 

sounds. pi2.play() 

104. 

else: 

058. 

if player.lives == 0: 

105. 

player.image = "piman_cr" 

059. 

player.status = 3 

106. 

else: 

060. 

music .fadeout(3) 

107. 

if a != 180: 

061. 

else: 

108. 

player.image = "piman_o" 

062. 

player.status = 1 

109. 

else: 

063. 

if player.inputActive: 

110. 

player.image = "piman_or" 

064. 

gameinput. checklnput (player) 

111. 

player.angle = a 

065. 

gamemaps. checkMovePoint (player) 

112. 


066. 

if player.movex or player.movey: 

113. 

def drawFlamesQ : 

067. 

inputLockQ 

114. 

for g in range(len(flames)) : 

068. 

sounds. pil.play() 

115. 

if flames[g].x > player.x: 

069. 

animate(player, pos=(player.x + player, 
movex, player.y + player.movey), duration=l/SPEED, 

116. 

if flames[g].status > 200 or (flames[g].status 
> 1 and flames[g].status%2 == 0): 


tween= 'linear' , on_finished=inputUnLock) 

117. 

flames[g].image = M flame"+str(g+l)+"- " 

070. 

if player.status == 1: 

118. 

else: 

071. 

i = gameinput .checklnput (player) 

119. 

flames[g].image = "flame"+str(g+l)+"r" 

072. 

if i == 1: 

120. 

else: 

073. 

player.status = 0 

121. 

if flames[g].status > 200 or (flames[g].status 

074. 

player.x = 290 


> 1 and flames[g].status%2 == 0): 

075. 

player.y = 570 

122. 

flames[g] .image = ,, flame"+str(g+l)+"-" 

076. 

if player.status == 2: 

123. 

else: 

077. 

i = gameinput .checklnput (player) 

124. 

flames[g].image = "flame"+str(g+l) 

078. 

if i == 1: 

125. 

flames[g] .drawQ 

079. 

initQ 

126. 


080. 


127. 

def moveFlamesQ: 

081. 

def initQ: 

128. 

global moveFlamesFlag 

082. 

global player, level 

129. 

dmoves = [ (1,0),(0,1),(-1,0),(0,-1) ] 

083. 

initDotsQ 

130. 

moveFlamesFlag = 0 

084. 

initFlamesQ 

131. 

for g in range(len(flames)) : 

085. 

player.x = 290 

132. 

dirs = gamemaps. getPossibleDirection(flames[g] ) 

086. 

player.y = 570 

133. 

if inTheCentre(flames[g] ): 

087. 

player.status = 0 

134. 

flames[g].dir = 3 

088. 

inputUnLockQ 

135. 

else: 

089. 

level += 1 

136. 

if g == 0: followPlayer(g, dirs) 

090. 

music. play("pml") 

137. 

if g == 1: ambushPlayer(g, dirs) 

091. 

music. set_volume(0 . 2) 

138. 


092. 


139. 

if dirs[flames[g].dir] == 0 or randint(0, 50) == 0: 
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140. 

141. 

142. 

143. 

144. 

145. 

146. 

147. 

148. 


149. 

150. 

151. 

152. 

153. 

154. 

155. 

156. 

157. 

158. 

159. 

160. 
161. 
162. 

163. 

164. 

165. 

166. 

167. 

168. 

169. 

170. 

171. 

172. 

173. 

174. 

175. 

176. 

177. 

178. 

179. 

180. 
181. 


d = -1 

while d == -1: 

rd = randint(0,3) 

if aboveCentre(flames[g] ) and rd == 1: 
rd = 0 

if dirs[rd] == 1: 
d = rd 

flames[g].dir = d 

animate(flames[g] , pos=(flames[g] .x 
+ dmoves[flames[g].dir] [0]*20, flames[g].y + 
dmoves[flames[g].dir] [1]*20) 3 duration=l/SPEED, 
tween= 'linear , on_finished=flagMoveFlames) 


def followPlayer(g, dirs): 
d = flames[g].dir 
if d == 1 or d == 3: 

if player.x > flames[g].x and 
flames[g].dir = 0 

if player.x < flames[g].x and 
flames[g].dir = 2 

if d == 0 or d == 2: 

if player.y > flames[g].y and 
aboveCentre(flames[g]) : flames[g].dir 
if player.y < flames[g].y and 
flames[g].dir = 3 


dirs[0] == 1: 
dirs[2] == 1: 


dirs[l] == 1 and not 
= 1 

dirs[3] == 1: 


def ambushPlayer(g, dirs): 
d = flames[g].dir 

if player.movex > 0 and dirs[0] == 1: flames[g].dir = 0 

if player.movex < 0 and dirs[2] == 1: flames[g].dir = 2 

if player.movey > 0 and dirs[l] == 1 and not 

aboveCentre(f lames[g]): flames[g].dir = 1 

if player.movey < 0 and dirs[3] == 1: flames[g].dir = 3 

def inTheCentre(ga) : 

if ga.x > 220 and ga.x < 380 and ga.y > 320 and ga.y < 

420: 

return True 
return False 

def aboveCentre(ga) : 

if ga.x > 220 and ga.x < 380 and ga.y > 300 and ga.y < 

320: 

return True 
return False 

def flagMoveFlamesQ : 

global moveFlamesFlag 
moveFlamesFlag += 1 


182. 

183. 

184. 

185. 

186. 

187. 

188. 

189. 

190. 

191. 

192. 

193. 

194. 

195. 

196. 

197. 

198. 

199. 

200 . 
201 . 
202 . 

203. 

204. 

205. 

206. 

207. 

208. 

209. 

210 . 
211 . 
212 . 

213. 

214. 

215. 

216. 

217. 

218. 

219. 

220 . 
221 . 
222 . 

223. 

224. 

225. 

226. 

227. 

228. 

229. 

230. 


def flameCollided(ga,gn) : 

for g in range(len(flames)) : 

if flames[g]. colliderect(ga) and g != gn: 
return True 
return False 

def initDotsQ: 

global piDots 
piDots = [] 
a = x = 0 
while x < 30: 
y = 0 

while y < 29: 

d = gamemaps.checl<DotPoint(10+x*20, 10+y*20) 
if d == 1: 

piDots. append(Actor( "dot", (10+x*20, 

90+y*20) )) 

piDots[a].status = 0 
piDots[a].type = 1 
a += 1 
if d == 2: 

piDots. append(Actor( "power" , (10+x*20, 

90+y*20) )) 

piDots[a].status = 0 
piDots[a].type = 2 
a += 1 
y += 1 
x += 1 

def initFlamesQ : 

global flames, moveFlamesFlag 
moveFlamesFlag = 4 
flames = [] 

g = 0 

while g < 4: 

flames. append(Actor ("flame"+str(g+l) , (270+(g*20), 

370))) 

flames[g].dir = randint(0, 3) 
flames[g].status = 0 
g += 1 

def inputLockQ : 
global player 

player.inputActive = False 

def inputllnLockQ : 
global player 

player.movex = player.movey = 0 
player.inputActive = True 

init() 

pgzrun.goQ 
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This isn’t just a book about a computer: 

it’s a book with a computer. Almost 
everything you need to get started with 
Raspberry Pi is inside this kit, including 
a Raspberry Pi 3A+ computer, an official 
case, and a 16GB NOOBS memory card 
for the operating system and storage. 

116-page guide shows you 
how to master Raspberry Pi 
in easy steps: 

# Set up your Raspberry Pi 3A+ for 

the first time 

# Discover amazing software built 

for creative learning 

# Learn how to program in Scratch 

and Python 

# Control electronics: buttons, 
lights, and sensors 
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You’ll Need 

> Raspbian 

> An image 
manipulation 
program such as 
GIMP, or images 
available from 
magpi.cc/pgzero8 

> The latest version 
of Pygame Zero 

> Your brain switched 
to maths mode 


Pygame Zero 

AmazeBalls 
isometric game 

Pygame Zero in 3D, Yes it's possible and we will show 
you how in this three-part maze game tutorial 


n this series so far, we have learnt how to 
use Pygame Zero to quickly create games. 

In this three-part tutorial, we will use several 
more new techniques to create a 3D maze game. 
The style of 3D graphics we’ll be using is called 
isometric. That means that our display will be 
made of regular cubes that have a slightly false 
perspective because the display is actually made 
of 2D images. This technique was used in many 
eighties games such as Knight Lore, Alien 8, and 
my own series, ArcVenture. In this first part, we’ll 
build the basic map using data lists, and create 
a bouncing ball character for the player to move 
around the maze. 


the game area for the player to move around using 
the keyboard. We’ll start the ball at one side of the 
maze and when the player guides it to the other 
side, the game is complete. 


Map-making 

As usual in this series, we start with 
importing our pgzrun module and don’t forget 


The ball starts at one side of the maze and 
the player must guide it to the other side 


02 


Welcome to the third dimension 

Pygame Zero was not written with 3D games 
in mind, but sometimes you just have to push the 
boundaries a little and see how far you can take an 
idea. This method of drawing a game area is not 
strictly speaking a 3D display, but it does look 3D 
and we can do a lot with this technique. We are 
going to make a map from list data and build it up 
out of cubes. We will then put a bouncing ball into 


Walls of the maze created 
by drawing cubes 



Player is represented 
as a bouncing ball 
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to call pgzrun.goQ right at the end of the code. 

The default window size should suit our purposes. 
We are going to make a two-dimensional list of 
numbers that will represent our map. Each number 
will represent one square on the map and we will 
make our map twelve squares wide and twelve 
squares high. See figurei.py to see how we define 
this list, which we will call mapData. You will also 
see another variable called maplnfo that defines 
the width and height of our map in a structure 
called a dictionary. 


A is for aardvark 

A dictionary in Python is a very useful data 
structure. Rather than just storing a list of values 
or strings, we can give each of these values a label. 
Looking at our maplnfo dictionary, we can see that 
there are two values declared; the first has the label 
'width’ and the second 'height’. To read the values 
back, we just need to write maplnfo ["width"], 
which would give us the value 12 in this case. 
Dictionaries are a very useful structure to gather 
together several variables that are all associated and 
can be referred to by their labels. 



A The blocks build back to ▼ Our basic Pygame Zero 

front one row at a time to framework and our map 

produce the 3D effect data definitions 


Mapping the map 

Now that we have some data for our map, 
we need to define some images that are going 
to be used to draw the map. We can make a 
new list of map blocks by writing mapBlocks = 
["maplc"/ , map2c"]. What this will do is define 
that when we see a o in the mapData list, it means 
draw the first image in the list, which is maple. 

If we see a l in the data, then use image map2c. 
For the moment, we’ll just stick to two different 
map blocks. The first will represent the floor; the 
second, the walls. 


Show me the map 

Next is to get our map data translated into 
a visual map we can see on the screen. We’ll set up 
the basics in our Pygame Zero draw( ) function and 
then call a drawMap( ) function that we’ll write to 
do the work. In figure2.py, you’ll see that we fill 
the screen with black first, then draw our map. The 
drawMapQ function, although short, may look a bit 
complicated, so let’s go through it slowly as you’ll 
need to understand what is happening here. 


figurei.py 

DOWNLOAD 

THE FULL CODE: 

> Language: Python 

magpi.ee/pgzero8 


001. import pgzrun 

002. 


003. mapData = 

[[1,1,1,0,1,1,1,1,1,1,1,11, 

004. 

[i,0,0,0,0,0,0,0,0,0,0,i]. 

005. 

[i,i,i,i,i,i,i,0,i,i,i,i]. 

006. 

[i,0,0,0,0,0,0,0,0,0,0,i]. 

007. 

[i,i,i,i,i,i,i,i,0,0,0,i]. 

008. 

[i,0,0,0,0,0,0,i,0,i,i,i]. 

009. 

[i,0,i,0,i,i,0,i,0,0,0,il 

010. 

[i,0,i,0,i,0,0,i,i,i,0,il 

011. 

[i,0,i,0,i,0,0,0,0,0,0,i]. 

012. 

[i,i,i,0,i,i,i,i,i,i,i,i]. 

013. 

[1,0,0,0,0,0,0,0,0,0,0,1], 

014. 

[1,1,1,1,1,1,1,1,0,1,1,11] 

015. 


016. maplnfo = 

{"width" :12, "height":12} 

017. 


018. pgzrun. go() 

019. 
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figure2.py 


001. OFFSETX = 368 
002. OFFSETY = 200 
003. mapBlocks = [ maple 1 /'map2c ] 

004. mapFleight = [0,32] 

005. 

006. def dnaw(): # Pygame Zeno draw function 
007. screen. fill((0, 0, 0)) 

008. drawMapQ 

009. 

010. def drawMapQ: 

011. for x in range(0, 12): 

012. for y in range(0, 12): 

013. screen.blit(mapBlocks[mapData[x][y]], ((x*32)- 

(y*32)+0FFSETX, 

014. (y*16)+(x*16)+0FFSETY - 

mapFleight[mapData[x] [y] ])) 

015. 


Building blocks 

We are going to use a nested loop to run 
through our data and display the map. The first 
loop is for the x direction and inside that we have 
another loop for the y direction. The x and y in this 
case do not refer to screen pixel coordinates but to 
the data blocks. Now imagine that we are going to 
turn our data 45 degrees so that we draw our blocks 
diagonally down the screen. We do this with a bit of 
maths to translate the x and y positions in our data 
to locations on the screen. 


An amazing view 

To draw each block, we use the Pygame Zero 
screen. blit () function, which loads an image and 
draws it at the specified coordinates on the screen. 
So the first parameter of this function is the name 


The nuts and bolts of the 
map drawing functions 

This map technique was 
used with several 8-bit 
games and was still being 
used for the early versions 
of Sim City and Age 
of Empires 
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of the image. We obtain this by getting the value 
from mapData[x] [y] and use mapBlocks to give 
us an image name. Now we calculate the screen 
coordinates. The width of each block is 64 pixels, 
but because we are printing diagonally we only 
want to move 32 pixels sideways for each block so 
that they overlap each other. In the down direction 
we move 16 pixels for each block. 


Diamonds are forever 

To get our screen x coordinate, we multiply 
the data x value by 32 and subtract that from 
the data y value times 32. That gives us a screen 
x coordinate starting from 0. We then add a 
predefined offset to move the starting block to the 
middle of the screen. We do the same to get the 
screen y coordinate but use a multiplier of 16 for 
the data x and y, add an offset to move the start 
block down the screen a bit, and take into account 
that some blocks are taller than others using 
mapHeight. When this runs, we’ll see twelve rows 
and twelve columns drawn in a diamond shape. 


□ Well make a dictionary to 
hold all the data we need 
to know about the player □ 


Balls 

Now it’s time to make our player character, 
which in this case will be represented by a 
bouncing ball. We’ll start by getting the ball 
positioned and moving around the map first. We’ll 
make a dictionary to hold all the data we need to 
know about the player. See figure3.py for how 
we define the player data. The x and y values are 
where the player is in the block data map. We will 
start the player in column(x) 0 and row(y) 3. The 
frame value will tell us which frame of animation 
to show. The sx and sy values are the actual screen 
coordinates where the ball will be drawn. 


Blitting the player 

Leaving aside the other values in our player 
dictionary for the moment, the other piece of code 
in figure3.py goes inside our drawMapQ loops just 


after we blit the blocks. The code says “if the block 
we are currently dealing with is the block that the 
player is on, work out the screen coordinates (using 
the same calculation as the blocks) and draw the 
ball to the screen.” We only work out the screen 
coordinates of the ball once, as we’ll now make 
a doMove() function that will handle the player 
screen coordinates from here. 


on the move 

Our doMove() function will introduce a 
couple of new Python techniques and some more 
of the player dictionary data. We pass doMove () 
three parameters. The first is the player dictionary 
structure (so we can read and write player values), 
and then the x and y change we want to make 
in block units. The x and y will be 0,1 or -1 and 
represent a movement in our map block data. 

The first bit of doMove() will check to make sure 
that the block we are moving to is within the 
bounds of our map. This is a shorthand way of 
comparing several values and in simple terms is 
0 <= x < width , which means x needs to be between 
0 and width minus 1. See figure4.py for the actual 
code to use. 


Top Tip 


Data 

formatting 


If you are using 
hand-coded data, 
it's a good idea 
to format it in a 
way you can read 
it easily. 


▼ Defining the pLayer 
data structure and 
drawing the pLayer 
character to 
the screen 


figure3.py 


001 . 

002 . 

003. 

004. 

005. 

006. 

007. 

008. 

009. 

010 . 

011 . 

012 . 

013. 

014. 

015. 

016. 


# This code is near the top of our program 

player = {"x":0, "y" :3, "frame" :0, "sx" :0, "sy":0, 

"moveX":0, "moveY":0, "queueX":0, "queueY":0, 
"moveDone" :True, "movingNow" : False, 
"animCounter" :0} 


# This code goes in the drawMapQ function inside the y loop 


if x == player[ "x"] and y == player[ "y 1 ]: 
if player[ sx"] == 0: 

player ["s> ] = (x*32)-(y*32)+0FFSETX 
player ["sy ] = (y*16)+(x*16)+0FFSETY-32 
screen. blit (" ball "+str( player ["f rame"] ), 
(player[ ’s> ], playen["sy ])) 
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figure4.py 


001. 

def updateQ: # Pygame Zero update function 

002. 

global player 


003. 

if player[ moveDone"] == True: 


004. 

if keyboard.left: 


005. 

doMove(player, -1, 0) 


006. 

if keyboa rd.right: 


007. 

doMove(player, 1, 0) 


008. 

if keyboard.up: 


009. 

doMove( player, 0, -1) 


010. 

if keyboard.down: 


011. 

doMove(player, 0, 1) 


012. 

013. 

updateBall (player) 


014. 

def doMove(p, x, y): 


015. 

if 0 <= (p["x"]+x) < mapInfo["width"] 
(p["y"]+y) < mapInfo["height ]: 

and 0 <= 

016. 

if mapData[p["x"]+x] [p["y ]+y] == 

0: 

017 

018. 

p.update({"queueX'' :x, "queueY 1 
"moveDone" : False}) 

•y> 


▲ Getting keyboard 
input and responding 
by setting up the 
data for moving the 
pLayer character 


Top Tip 4 


Dictionaries 


Organising data 
in dictionaries 
makes it easier 
to understand 
what the data 
is used for. It’s 
also a good 
stepping stone 
towards using 
object-oriented 
programming 
(OOP) 


Watch your step 

After we have checked the player movement 
will be inside the map area, we can test to see if 
the movement will be to a floor block (value o 
in our data). We just need to check the value in 
mapData and we are good to go. The next line of 
code is a clever way of changing several values in 
a dictionary. We use the dictionary p. update() 
function to set queueX, queueY, and moveDone 
values all at the same time. The reason we are 
queueing the movement rather than just moving is 
because we may already be moving and we want to 
wait until the end of the previous move. 


The update 

Staying with figure4.py, we can see how 
to get our movement controls from the keyboard. 

In the Pygame Zero function update() we look 
for the cursor keys being pressed and if so, call 
our doMoveQ function with suitable movement 
parameters. When we have checked for movement, 
we then call a function updateBallQ which will 
do all the heavy lifting of animating the ball and 
moving it from one block to the next. You will 


notice that before we check the keyboard, we make 
sure that we are ready for more input by checking 
the player dictionary value moveDone, which we set 
to False in doMoveQ. 


Sequencing the animation 

All we have left to do now is get the ball 
to move from one block to the next, but if we get 
things in the wrong sequence we can end up with 
the ball being drawn in front of blocks that it is 
meant to be behind, or behind blocks that it should 
be in front of. At this stage we can bring in the 
changing frames of the animation to make the ball 
bounce up and down. We also want to make the 
ball move smoothly from one place to another, so 
the smaller the movement from one draw() to the 
next, the better. 


□ The reason we are 
queueing the movement 
rather than just moving is 
because we may already 
be moving □ 


You've been framed 

Let’s start with the animation frames for 
the bouncing ball. We have eight frames named 
ballo.png up to ball 7 .png. If we just increase the 
frame value in our player dictionary each time we 
call updateBall() and when we get to 8 set the 
value back to o, our drawMapQ function will take 
care of drawing the animation in a loop. The only 
problem with this is that if we run the animation 
at this speed, the ball is bouncing very fast so we 
need to slow it down. For this we use another value 
from our player dictionary, animCounter. With 
this value, we count every four frames and on the 
fourth frame we add one to the frame value. 


15 


Frame by frame 

We need to time the movement of the ball 
with the correct frames so that it looks like it’s 
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bouncing smoothly while moving. We want to 
wait until frame = 4 before starting the move. At 
that point we move our queueX and queueY values 
into moveX and moveY, and set movingNow to True. 
When movingNow is True, the sx and sy values of 
the player are changed. For each block, we need to 
move 32 pixels left or right in 1 pixel increments, 
and 16 pixels up or down in 0.5 pixel increments. 
So our move will take 32 update cycles. 


one block to the next 

For our moving ball to be displayed 
correctly in the drawing order of the map, we 
need to change the block it is located at on the 
correct frame of the animation. When frame = 7 
is the time to change, so at that point we update 
the player dictionary x and y values based on the 
moveX and moveY values. We then set the player 
moveDone value to True. This will mean that when 
we return to frame = 4, we can clear moveX and 
moveY, and set movingNow to False unless another 
move has been queued. 


Wrapping it up 

You can see from figures.py how this 
frame sequencing works in the updateBall() 
function. You will see the check for movingNow first 
and use a separate function, moveP(), to change 
the screen coordinates of the player. Then we do all 
the logic around sequencing actions to the current 
frame. YouTl also see a check to see if the maze has 
been solved. We set a global variable, mazeSolved, 
to False at the start and if the player arrives at 
block 11 , 8 we set the variable to True and display a 
suitable message in draw(). 


Level one complete 

So that’s the first part of this tutorial. We 
have looked at creating a 3D-looking map from 
data and 2D images, and how to move an animated 
character around the map. This game format has 
a lot of possibilities and in the next episode we’ll 
look at making the map larger, editing the map 
data in an external editor, and loading the data 
from a separate file. E 3 



If a move is queued, then start the 
player moving on the screen, 
otherwise stop the player moving 
now. 


If the player is moving then 
move the data block that the 
player is on. 


figure5.py 


001 . 

002 . 

003. 

004. 

005. 

006. 

007. 

008. 

009. 

010 . 

011 . 

012 . 

013. 

014. 

015. 

016. 

017. 


018. 

019. 

020 . 

021 . 

022 . 

023. 

024. 

025. 

026. 


def updateBall(p) : 
global mazeSolved 
if p[ "movingNow" ]: 

if pf'moveX"] == -1: moveP(p, -1,-0. 5) 
if p["moveX"] == 1: moveP(p, 1,0. 5) 
if p["moveY"] == -1: moveP(p,l, -0. 5) 
if p[ moveY"] == 1: moveP(p, -1,0.5) 
p[ animCounter"] += 1 
if p[ jnimCounter' ] == 4: 
p[ 'animCounter ] = 0 
p[ 'frame ] += 1 
if p[ "frame"] > 7: 

p[ "frame"] = 0 
if p[ frame"] == 4: 

if p["moveDone"] == False: 

if p["queueX"] != 0 or p[ "queueY" ] ! =0 : 
p.update({ ’moveX" :p[ "queueX"], 
"moveY" :p[ "queueY"], "queueX" :0, "queueY" :0, 
"movingNow": True}) 
else: 

p. update({ "moveX" :0, "moveY" :0, 
"movingNow" : False}) 

if p["x ] == 11 and p["y"] == 8: 
mazeSolved = True 


if p[ frame"] 
p[ movingNow" ] == True: 

p["x ] += p[ "moveX'] 
p["y ] += p[ "moveY'] 
p[ "moveDone ] = True 


7 and p[ moveDone"] == False and 
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You’ll Need 

> Raspbian 

> Tiled (free map 
editor) 

mapeditor.org 

> An image 
manipulation 
program such as 
GIMP, or images 
available from 
magpi.cc/pgzero9 

> The latest version 
of Pygame Zero 


Pygame Zero 

AmazeBalls: part 2 

Pygame Zero in 3D, Let's moke the map bigger in part 
two of this three-part tutorial 


I n this second part of our tutorial on using 
Pygame Zero to create a 3D isometric game, 
we will start from where we left off in the 
last part and look at ways to make our 3D area 
larger and easier to edit. This will mean using a 
map editor called Tiled, which is free to download 
and use, to make your own 3D maps. We’ll 
learn how to create a simple map and export it 
from Tiled in a data format called JSON. We will 
then import it into our game and code our draw 
function to scroll around the map area when the 
player moves. Lots to do, so let’s get started. 


Tools for the job 

In the previous part of this tutorial, we 
made our map data by writing a two-dimensional 
list of zeroes and ones which represented either a 
floor block or a wall block. The player was able to 
move onto any block that was a zero in the data. 
This time we are going to get a map-editing app 
to do the work for us instead of typing the data 
in. First, we need to get Tiled installed. You can 
find the Tiled homepage at mapeditor.org, where 
options are given to support the developer if you 
like what they are creating. 


Getting Tiled 

Tiled can be used on many different 
systems, including PCs and Mac computers. Also, 
more importantly for us, it works really well on 
Raspbian and Raspberry Pi. It’s also super-easy to 
install. All you need to do is open up a Terminal 
window, then make sure you’re online and are 
up-to-date by typingsudo apt-get update. You 


may need to type sudo apt-get upgrade too, 
depending on how long you’ve left your Pi without 
updates. When those have run, just type sudo apt- 
get install tiled, hit RETURN, and you should 
see Tiled being installed. When it’s done, a new 
Tiled icon will appear in your Graphics submenu. 


Cartography 

Previously our map was 12 blocks by 12, 
which all fitted on the screen at once. With our map 
editor we can make a much bigger map. It could be 
huge, but for the moment let’s stick to a grid of 30 
by 30 blocks. You may want to download our ready¬ 
made map and blocks from magpi.cc/pgzer09. If 
you load in the map, you should see a blue and red 
maze, a bit like in part one but much bigger. This 
time, though, we have added a new block to indicate 
the finish point in the maze. You should be able to 
scroll around to see the whole map. 


Exporting the data 

Have a play around with the map editor; 
there is some great documentation on the website. 
When you have familiarised yourself with how it 
works, we can think about the task of getting the 
map data into our game. To export the data, go to 
Export in the File menu and when the dialogue 
box opens up, asking 'export as...’, find a suitable 
place (perhaps a subdirectory called maps) to 
save the map (perhaps as mapi), but in the drop¬ 
down labelled 'Save as type’, select 'Json map files 
(*.json)’. This type of file (pronounced 'Jay-son’, 
short for JavaScript Object Notation) can be viewed 
in a text editor. 
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The player must complete 
the maze in the fastest 
time possible 


An external editor is used 
to create the maze 


The maze is bigger than the 
game window and scrolls 
around with the player 




▲ When we have rewritten our drawMapQ function, we will see 
some jagged edges around the extremities of the drawing area 


JSON and the Argonauts 

If we open the JSON file, we will see a load of 
curly and square brackets with words and numbers 
spread all over the place, but before you proclaim 
'It’s all Greek to me!', let’s have a look at some 
of the elements so that we can understand the 
structure of the data. If you are familiar with the 
JavaScript language, you’ll recognise that the curly 
brackets { and } are used to contain blocks of code 
or data, and square brackets [ and ] are used for 
lists of data. Look at the element called 'layers’ and 
you will see data describing our map. 


Loading the data 

For this game we don’t actually need all 
the data that is in the JSON file, but we can load 
it all in and just use the bits we need. Let’s make 


figurel.py 


001. import json 
002. import os 
003. 

004. def loadmap(mp): 

005. with open(mp) as json_data: 

006. d = json.load(json_data) 

007. mapdata = { width' :d ["width ], "height" :d ["height ]} 

008. rawdata = d[ "layers' ][0][ "data 1 ] 

009. mapdata["data"] = [] 

010. for x in range(0, mapdata[ "width ]): 

011. st = x*mapdata[ "width ] 

012. mapdata["data' ] .append( 

rawdata[st:st+mapdata[" height ]]) 

013. 

014. tileset = "maps/" + d["tileseti ][0][ source"] . replace( 

" .tsx'L ,json") 

015. with open (tileset) as json_data: 

016. t = json. load (json_data) 

017. 

018. mapdata["tiles"] = t["tiles"] 

019. for tile in range(0, len(mapdata[ "tiles ])): 

020. path = mapdata ["tiles ][tile] ["image ] 

021. mapdata["tiles"] [tile] ["image"] = 

os.path.basename(path) 

022. mapdata[ 'tiles ][tile][ id ] = 

mapdata[ tiles"] [tile][ .d"]+l 

023. return mapdata 
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Start blitting blocks here 


First block is at this 
offset from player 

This is the player 
" 000 'x,y co-ordinates 


Game Window 


Stop blitting blocks here 


▲ Figure 2 The 

coordinates that 
the map starts from 
are calculated as 
an offset from the 
player, and the 
maze blocks are 
only drawn inside 
the rectangle of the 
game window 


a new module to deal with map handling, like we 
have done in previous tutorials (see Hungry Pi- 
Man on page 82). Let’s make a new module called 
map3d.py. Python provides a module to import 
JSON files, so we can write import j son at the top 
of our map3d.py file to load the module. We’ll also 
need to use the os module for handling file paths, 
so import that too. Then we just need to write a 
function to load our map. 


Top Tip 4 


Looking at 
JSON 


You can look at 
JSON files in any 
text editor, but 
a programming 
one is probably 
best - perhaps 
try Geany. 


► We have added 
a new tile for the 
finish. When the 
player moves onto 
this block, the maze 
is solved 


Getting what we need 

Let’s make a function called loadmapQ 
and use a parameter called mp to pass a file location 
to the function. Have a look at figurei.py to see 
how we write this. You can see that we load in 
our map data into a variable d using the function 
j son. load (). Then we can copy the width and 



height into a dictionary called mapdata. This 
dictionary will hold all the data we need by the 
time we get to the end of the function. Having 
made a temporary copy of the block data (rawdata), 
we can then loop through the values and put them 
in the format we want in mapdata. 


The tileset connection 

One bit of information that we need is 
where to find the details about which images to 
use on each block. This is included as a value called 
( tilesets’. In this case we will assume that we only 
have one tileset defined, so we can read it in and go 
and find our block images. Except there is a slight 
crinkle in the plan. Our map data refers to the 
tileset file as a .tsx file. What we need to do is go 
back to Tiled and export our tileset from the tileset 
editor as a JSON file. Then, when we import it, we 
just switch the .tsx extension for .json. 


A night on the tiles 

Once we have loaded in our tileset data as 
a JSON file, we can then loop through the tiles 
and get the names of each of our block images. 
You will note that we add one to the id value to 
match the values that Tiled has exported. When 
we have all that data in our mapdata dictionary, 
we can pass that back to our main program by 
writing return mapdata. Going back to our main 
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program, we’ll need to add an import for our 
map3d module at the top of the code and then, 
before our draw() function, we can write mapData 
= map3d.loadmap("maps/mapl.json")instead of 
our list of zeroes and ones. 


Thinking big 

In part one of this tutorial, our maze was 
12x12 blocks, which just fitted nicely into the game 
area. Now we have a 30x30 maze which, if we draw 
it all, will go off the sides of the game window. We 
need to be able to scroll the map around the screen 
as the player moves through the maze. The way 
we can do this is to keep the bouncing ball in the 
centre of the game area and, as the player moves, 
scroll the map. So, in effect, what we are saying is 
that we are going to draw the map relative to the 
player rather than relative to the game window. 


figure3.py 


001 . 

002 . 

003. 

004. 

005. 

006. 

007. 

008. 

009. 

010 . 

011 . 

012 . 

013. 

014. 

015. 

016. 

017. 

018. 

019. 


def drawMapQ: 

psx = OFFSETX 

psy = OFFSETY-32 

mx = psx - player[ sx"] 

my = psy - player[ s> ]+32 

for x in range(player[ 'x' ]-12, player["x ]+16): 

for y in range(player["y' ] -12, player[ ]+16): 
if onMap(x,y): 

b = mapData[ 'dati ][y][x] 

td = findData (mapData ["tiles ], "id", b) 

block = td["imag< ] 

bheight = td[ 'imageheight ]-34 

bx = (x*32)-(y*32) + mx 

by = (y*16)+(x*16) + my 

if -32 <= bx < 800 and 100 <= by < 620: 

screen. blit (block, (bx, by - bheight)) 
if x == playerf": ] and y == playerf"} ]: 
screen. blit ( "bal +str(player[ : rame" ]), 

(psx, psy)) 


▲ The updated drawMapQ function 


It's all relative 

To draw our map, we are going to use the 
same basic loops (x and y) as before, but we will 
start drawing our map based on the coordinates 
we calculated for the player screen x and y 
coordinates. With that starting screen position, 
we loop in a range that is either side of the player 
in both directions. See Figure 2 for a visual 
explanation of what we are doing in these loops. In 
simple terms, what we are saying is: ‘Start drawing 
the map from coordinates that will make the player 
appear in the centre of the window. Then only 
draw the blocks that are visible in the window.’ See 
figure3.py for how we have changed the drawMap() 
function to do this. 


Extra functions 

You will see in figure3.py that we have a 
couple of new functions that we have not defined 
yet. The first is onMap(), which we pass an x and 
a y coordinate to. These are block locations which 
we test to make sure that the coordinates we are 
asking for are actually on our map, otherwise we 
will get an error. If the x or y are less than 0 or 
greater than the width (or height) of the map, then 
we can ignore it. The other function is findData (). 
This function finds the data associated with a tile 
of a given id. Look at figure4.py (overleaf) to see 
how these functions are written. 


map3d.py 


> Language: Python 


001. # 3dmap module for AmazeBalls 

002. import json 
003. import os 
004. 

005. def loadmap(mp): 

006. with open(mp) as json_data: 

007. d = json.load(json_data) 

008. mapdata = { width’ :d[ "width ], "height" :d[ neight ]} 

009. rawdata = d["layers"] [0] ["data 1 ] 

010. mapdata["data"] = [] 

011. for x in range(0, mapdata[ 'width ]): 

012. st = x*mapdata[ "width ] 

013. mapdataf'data' ] .append (rawdata[st:st+mapdata ["height ]]) 

014. 

015. tileset = "maps/" + d["tilesetf ][0][ source"] . replace( 

" .tsx", .json") 

016. with open (tileset) as json_data: 

017. t = json.load(json_data) 

018. 

019. mapdata[ "tiles ] = t["tiles ] 

020. for tile in range(0, len(mapdata[ "tiles ])): 

021. path = mapdata ["tiles ][tile] ["image"] 

022. mapdata ["tile* ][tile] ["image"] = os.path.basename(path) 

023. mapdata[ 'tiles ][tile][ id ] = mapdataf tiles' ][tile] ["id 1 ]+l 

024. return mapdata 
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figure4.py 


001. def onMap(x,y): 

002. if 0 <= x < mapData[ width"] and 0 <= y < mapData ["height ]: 

003. return True 

004. return False 

005. 

006. def findData(lst, key, value): 

007. for i, die in enumerate(lst) : 

008. if die[key] == value: 

009. return die 

010. return -1 


▲ The functions to 
test if a coordinate 
is inside the map 
area - onMap() - and 
findDataQ, which 
finds tile data for 
map drawing 


Masking the edges 

If we draw our map now, we have lost that 
nice diamond shape map. And if we move the player 
down the map, we get a jagged edge at the top and 
blocks popping in and out of view as our d rawMap () 
function decides which ones to draw in the range. We 
can tidy this up by overlaying a frame that obscures 
the edges of the printed area. We do this by having 
an image which covers the whole window but has 
a transparent cut-out area where we want the map 
blocks to be shown. We blit this frame graphic after 
we have called drawMap( ) in our draw( ) function. 


figureS.py 


001. def doMove(p, x, y) : 

002. if onMap(p[ x"]+x, p["y']+y): 
003. mt = 

mapData[ 'data"] [p["y ]+y][p[ x"]+x] 
004. if mt == 1: 

005. p.update({"queueX" :x, 

"queueY" :y, "moveDone" : False}) 

006. if mt == 3: 

007. mazeSolved = True 


▲ The updated doMove() function 


Over the finish line 

If we try to move onto the finish block, we 
won’t be able to, as our doMove( ) function is only 
detecting blocks we can move to as id l. So we need 
to add another condition. Instead of only testing 
mt for l, let’s make that line if mt == lormt == 3: 
(because the id of the finish tile is 3). We can then 
add a variable to set if the player moves onto the 
finish, by adding inside this condition: if mt == 

3: mazeSolved = True. We’ll also need to declare 
mazeSolved as global inside doMoveQ and set its 
initial value to False at the top of our program. 


I can't move! 

Now that we have our map drawing, if you 
are adding in code following on from part one, you 
may notice that we can’t move the bouncing ball 
any more. That’s because the data we have loaded 
is a slightly different format and has floor blocks 
as id 1 and walls as id 2, so at the moment our 
doMove( ) function is thinking we are surrounded by 
walls (which were id 1 in the last part). We need to 
change our doMoveQ function to accommodate the 
new data format. Have a look at figures.py to see 
what we need to write. 


14 


Time is running out 

Let’s add a timer to the game. When the 
player reaches the finish (mazeSolved is True), 
we can stop the timer and display a message. 

So, first we make a timer variable at the top of 
our program with timer = 0 and then, right at 
the end of the code, just before pgzrun. go( ), we 
can use the Pygame Zero clock function called 
schedule_interval(). If we write clock. schedule_ 
interval(timerTick, 1.0), then the function 
timerTickQ will be called once every second. 


Top Tip 


□rawing order 


Remember that 
in the draw() 
function, things 
are drawn in the 
order you call 
them, so always 
draw the things 
you want on 
top Last. 


Finding the exit 

Now that we have tidied up our display and 
got our ball moving again, we’ll need to change a few 
of the default values that we start with. In the last 
part, we had the player starting at x = 0 and y = 3. 

We will need to change those values to 3 and 3 in 
the player data at the top of the code to be suitable 
for this map. We’ll also want to change the OFFSETY 
constant to 300 to move the map a little further 
down the screen. We should now be able to guide the 
bouncing ball around the maze towards the bottom 
of the screen, where we should find the finish tile. 


The clock struck one 

So, all we need to do now is define the 
timerTickQ function. We’ll need to check if 
mazeSolved is False and add 1 to our timer variable 
if it is. Then we can add a screen.draw.text line 
to our draw( ) function to display the timer value 
and if mazeSolved is True, we can add some more 
text to say the maze has been solved and how many 
seconds it took. See the full program listing for 
how to write the code for those bits. 

In the next instalment, we are going to add 
some baddies to contend with and, just for good 
measure, we can throw in some dynamite! EU 
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amazeballs2.py 


DOWNLOAD 
THE FULL CODE: 


> Language: Python 


6 magpi.cc/pgzero9 


001 . 

002 . 

003. 

004. 

005. 

006. 

007. 

008. 

009. 

010 . 

011 . 

012 . 

013. 

014. 

015. 

016. 

017. 

018. 


019. 

020 . 


021 . 

022 . 

023. 

024. 

025. 

026. 

027. 

028. 

029. 

030. 

031. 

032. 

033. 

034. 

035. 

036. 

037. 

038. 

039. 

040. 

041. 

042. 

043. 

044. 

045. 

046. 

047. 

048. 

049. 

050. 

051. 

052. 

053. 

054. 


import pgzrun 
import map3d 

player = {"x" :3, "y" :3, "frame" :0, "sx" :0, "sy" :96, 

"moveX" :0, "moveY" :0, "queueX" :0, "queueY":0, 
"moveDone" :True, "movingNow" : False, 
"animCounter" :0} 

OFFSETX = 368 
OFFSETY = 300 
timer = 0 
mazeSolved = False 

mapData = map3d. loadmap("maps/mapl. json") 

def draw(): # Pygame Zero draw function 
screen. fill((0, 0, 0)) 
drawMapQ 

screen. blit ( title J , (0, 0)) 

screen draw. text ("TIME: "+str(timer) , topleft=( 

20, 80), owidth=0.5, ocolor=(255, 255,0), 
color=(255,0,0) , fontsize=60) 
if mazeSolved: 

screen draw. text ("MAZE SOLVED in + str(timer) 
+ " seconds!" , center=(400, 450), owidth=0.5, 
ocolor=(0,0,0), color=(0, 255,0) , fontsize=60) 


def updateQ: # Pygame Zero update function 

global player, timer 
if player[ moveDone ] == True: 

if keyboard.left: doMove( player, -1, 0) 
if keyboard right: doMove (player, 1, 0) 
if keyboard up: doMove (player, 0, -1) 
if keyboard down: doMove (player, 0, 1) 
updateBall (player) 

def timerTickQ: 

global timer 
if not mazeSolved: 
timer += 1 

def drawMapQ: 

psx = OFFSETX 

psy = OFFSETY-32 

mx = psx - player[ sx"] 

my = psy - player[ s> ]+32 

for x in range(player["x' ] -12, player ["x" ]+16) : 

for y in range(player[ 'y' ] -12, player["> ]+16): 
if onMap(x,y): 

b = mapData[ 'data"] [y][x] 
td = findData (mapData ["tiles ], "id", b) 
block = td[" image"] 
bheight = td[ 'imageheight ]-34 
bx = (x*32)-(y*32) + mx 
by = (y*16)+(x*16) + my 
if -32 <= bx < 800 and 100 <= by < 620: 
screen. blit (block, (bx, by - 

bheight)) 

if x == player[ ] and y == 


055. 

056. 

057. 

058. 

059. 

060. 

061. 

062. 

063. 

064. 

065. 

066. 

067. 

068. 

069. 

070. 

071. 

072. 

073. 

074. 

075. 

076. 

077. 

078. 

079. 

080. 

081. 

082. 

083. 

084. 

085. 

086. 

087. 

088. 

089. 

090. 

091. 

092. 


093. 

094 

095. 

096. 

097. 

098. 

099. 

100 . 

101 . 

102 . 

103. 

104. 

105. 

106. 


player["y ]: 

screen. blit ( 

"ball 1 +str(player[ frame']), (psx, psy)) 

def findData(lst, key, value): 
for i, die in enumerate(lst) : 
if die[key] == value: 
return die 
return -1 

def onMap(x,y): 

if 0 <= x < mapData[ 'width' ] and 0 <= y < 
mapData ["height ]: 

return True 
return False 

def doMove (p, x, y): 
global mazeSolved 
if onMap(p["x ]+x, p[ ]+y): 

mt = mapData[ lata'][p[ ]+y][p[ x"]+x] 
if mt == 1 or mt == 3: 

p.update({ 'queueX" :x, "queueY":y, 

"moveDone" : False}) 

if mt == 3: 

mazeSolved = True 

def updateBall(p) : 

if p[ "movingNow" ]: 

if p[ "moveX ] == -1: moveP(p,-l,-0.5) 
if p["moveX ] == 1: moveP(p,l,0.5) 
if p["moveY ] == -1: moveP(p,l, -0.5) 
if p[ "moveY ] == 1: moveP(p, -1,0. 5) 
p[ animCounter"] += 1 
if p[ "animCounter"] == 4: 
p[ "animCounter"] = 0 
p[ "frame"] += 1 
if p[ "frame"] > 7: 

p[ frame"] = 0 
if p[ "frame"] == 4: 

if p[ "moveDone' ] == False: 

if p[ |ueueX' ] != 0 or p[ queue\ ] !=0: 
p . update ({ "moveX" :p[ "queueX" ], 
"moveY" :p["queueY ], "queueX" :0, "queueY":0, 
"movingNow": True}) 
else: 

p. update ({"moveDone" :True, "moveX" :0, 
"moveY" :0, "movingNow" : False}) 

if p[ "frame"] == 7 and p[ "moveDone ] == False 
and p[ novingNow"] == True: 

P[ x "] += p ["moveX 1 ] 
p[ "y" ] += p ['moveY 1 ] 
p[ moveDone ] = True 

def moveP(p,x,y) : 

P[ sx"] += x 
p["sy' ] += y 

clock . schedule_interval (timerTick, 1. 0) 
pgzrun. go() 
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You’ll Need 

> Raspbian 

> Tiled (free map 
editor) 

mapeditor.org 

> An image 
manipulation 
program such as 
GIMP, or images 
available from 
magpi.cc/pgzero10 

> The latest version 
of Pygame Zero 


Pygame Zero 

AmazeBalls: part 3 

Pygame Zero in 3D. Let's moke some baddies and 
dynamite in this last part of the series 


W e*ll start from where we left off in the 
last part and add some extra elements 
to make a more challenging game. 

We’re going to add some baddie balls that roam 
around the maze, pushing walls about - so even 
if you know how to get to the finish, you may 
find your path is blocked. To give our player an 
antidote to being blocked in, we’ll add some 
dynamite for them to pick up and use. 


Changing colours 

Previously we had our ball bouncing around 
the maze by moving the drawing position of 
the map so that we are always viewing the area 
around the ball. Now we’ll add some more balls, 
but these will be working against the player so we 
need to make them a different colour. We can do 
this quite easily with a paint app like GIMP. Just 
load each frame and use a tool called < colorize < (in 
the Colors menu in GIMP). Make sure you save the 
frames as a different name; for example, put an 
( e’ for enemy in front of each file name. 


Recycling code 

We already have one ball bouncing around 
the maze - to get more balls, we’ll try to reuse the 
code that we already have. We can duplicate the 
dictionary data at the top of our code that we have 
for the player and call it enemyl instead of player. 
You will want to change the x and y values in the 
data to something like 13, which will put the enemy 
ball near the middle of the maze. Now that we have 
our enemy defined, we can recycle some code. 


Common update code 

We can use exactly the same updateBall() 
function as we do for the player, and that will 
deal with all the animation and movement of 
the enemy from one block to the next. All we 
need to do is add another call to updateBall() 
after the one we have in our Pygame Zero 
update () function. But this time, rather than 
passing the player dictionary to the function, 
we pass the enemyl dictionary by writing 
updateBall (enemyl). This means that if we set 
our enemy ball moving, all the changes to the data 
will be done in the same way as the player ball. 


□rawing the enemy 

Although we now have a way to update the 
animation of our enemy ball, we also need to write 
some code to draw it on the screen. This needs to 
be a bit different than the player ball because the 
enemy ball needs to move as the map is scrolled. 
We have to use both the map position and the sx 
and sy values of the ball to work out where it needs 
to be drawn. See figurei.py for the updates to the 
drawMap( ) function. You will see we are calculating 
the block position (bx and by) and then adding the 
sx and sy values. 


Enemy brains 

If we run our program now, we should see 
an enemy ball bouncing away in the middle of 
the maze. You’ll notice that both balls bounce at 
exactly the same time - if you wanted to have the 
bounces non-synchronised, you could change the 
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Collected dynamite can be 
used to demolish walls that 
block the player 


The player can pick up 
sticks of dynamite 


▼ Changes to drawMap() to 
incorporate the enemy ball 


initial frame value where enemyl is declared at the 
top of the code. Now let’s define a function called 
updateEnemy (); this will make the enemy ball 
move and also push some walls around. 


Getting random 

We are going to get the enemy to move 
around in a random way so, as we have done 
previously in this series, let’s use the random 
module to generate some random movement. At 
the top of our program we import the module with 
from random import randint. Let’s define our 
updateEnemy( )function as def updateEnemy(e):. 
The e variable is the enemy dictionary that we will 
pass into the function when we call it. Now let’s 
define some directions. We can do this with a list 
of x and y directions; for example, if we had x and y 
written as [0,1], that would mean move no blocks 
in the x direction and one block in the y direction. 


One direction 

So, we can define all four directions as edirs 
= [ [-1 ^ 0 ], [ 0 , 1 ], [ 1 , 0 ], [0,-1]]. And then all 
we need to do is pick one of them with a random 
number. To choose a random integer between o and 
3 , we writer = randint(0,3). Now we can reuse 


figurel.py 


> Language: Python 3 


001. 

002. 

003 . 

004 . 

005 . 

006 . 

007 . 

008 . 

009 . 

010 . 

011 . 

012 . 

013 . 

014 . 

015 . 

016 . 

017 . 

018 . 

019 . 

020 . 

021 . 


def drawMapQ: 

psx = OFFSETX 

psy = OFFSETY-32 

mx = psx - playerf'sx ] 

my = psy - player[ "sy" ]+32 

for x in range(player[ x"]-12, playerf "x" ]+16) : 

for y in range(player["y' ]-12, player ["y 1 ]+16) : 
if onMap(x,y) : 

b = mapData[ data"] [y][x] 

td = findData(mapData[ :iles"], "id", b) 

block = td[ "image"] 

bheight = td[ 'imageheight"] -34 

bx = (x*32)-(y*32) + mx 

by = (y*16)+(x*16) + my 

if -32 <= bx < 800 and 100 <= by < 620: 

screen. blit (block, (bx, by - bheight)) 
if x == playerf <"] and y == playerf "y ]: 
screen. blit ("ball"+str( player ["frame ]), 

(psx, psy)) 

if x == enemylf'x"] and y == enemylf'y ]: 
screen.blit("eball ,, +str(enemyl[ 

"frame"] ), (bx + enemylf "sx"] , (by-32)+enemyl[ sy ])) 
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figure2.py 

> Language: Python 3 

001 . 

def doMove(pj x, y): 


002 . 

global mazeSolved 


003. 

if onMap(p["x ]+x, p["y"] + y) : 


004. 

mt = mapData[ data ][p["y' 

]+y][p["x ]+x] 

005. 

if mt == 1 on mt == 3: 


006. 

p.update({"queueX' :x. 

"queueY" :y, 


"moveDone" : False}) 


007. 

if mt == 3 and p == player: 

008. 

mazeSolved = True 


009. 

return mt 



A Changes to doMove() to make sure that the enemy ball doesn't trigger the finish condition 


Top Tip 


Dynamic map 
data 


You can change 
any block on 
the map by 
changing the id 
in mapData. You 
could have lots 
of fun animating 
map elements in 
the update() 
function. 



A There are several 
ways of creating 
images for games, 
such as the free 3D 
modelling program 
called Blender 


the doMove( ) function that moves the player, but 
use it for our enemy. We do need to make a couple 
of alterations to the doMove( ) function. The first is 
to return the id of the block that is being moved to 
Then we can detect if a wall block is in the way; if 
it is, we can really mess things up for the player by 
moving the blocks around - sneaky, huh? 


Making a move 

The other problem that we have with the 
doMove( ) function is that it detects if the player 
has landed on the finish and if we use the same 
code for the enemy, we may get the finished 
condition triggered by the enemy instead of the 
player, so we need to change the mazeSolved 
condition to include a test to see if it's the player 
we are dealing with. Have a look at figure2.py to 
see these two changes to the doMove( ) function. 
When we've made those changes, we can go back 
to our updateEnemy() function. 


Dynamic blocks 

So far, all the blocks have stayed in the 
same place, but because they're all represented 
as numbers in our map data, we can change the 
numbers in the data and we’ll see the maze change 
on screen. For example, if a block has id 2, it is a 
wall block. If we change the data to say that it is id 
1, we’ll see the wall disappear and there will be a 
floor block in its place. So, we can make changes to 
the maze as the enemy ball bounces around. 



A When the dynamite is used, it changes alL the blocks around 
the player (shown in pink here) to floor blocks 


Moving the walls 

So, going back to our updateEnemy () 
function, we need to first generate a random 
number for our direction and then move the enemy 
ball in that direction. But if it moves towards a 
wall, then we attempt to move that wall block in 
the direction the enemy ball is moving. The other 
thing we need to check is that there is a space for 
the wall to move into. We need to make a call to 
doMove( ) using the enemyl dictionary (passed into 
updateEnemy ()) and then, if the block id is 2 (a 
wall), call another function called moveBlock(). 


Changing places 

We need to define the moveBlock() 
function and we will pass it the x and y block 
position in the map data and also the direction 
values that we are using to move the enemy ball. 
First, the function will check that we are moving 
data within the map area and then it will check 
that the block we are moving the wall to is a floor 
block (id 1). If this all checks out, then we copy the 
id of the block we are moving to the new position. 
Have a look at figure3.py to see the updateEnemy () 
function and the moveBlock( ) function. 


What are we doing? 

The figures.py code may look a bit daunting 
in places, so let's have a look at the detail. The 
updateEnemy () function is basically defining four 
directions to move in and then we are saying: if the 
enemy is not currently moving, then get a random 
direction and pass the x and y values of that 
direction to the doMoveQ function. If the block we 
are moving to is id 2, then move the block using 
the location we are moving to and the direction 
values. Then zero the screen x and y coordinates 
(sx and sy) of the enemy dictionary. 
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It's all relative 

You will notice that if the enemy is 
moving, then we check to see if we are on frame 
seven (when the ball actually moves from one 
block to another in the data) and if so, we fix up 
the coordinates so they are now relative to the 
new map location rather than the old one. The 
moveBlockQ function just checks directly with the 
mapData data to check that the block can be moved, 
moves the data from the source location to the 
target location, and sets the source location to be a 
floor block. 


Multiple enemies! 

When all that is done, we just need to add 
updateEnemy(enemyl) after our updateBallQ 
calls in the Pygame Zero update () function. Now, 
it may be that we consider that one enemy ball 
is not enough to make the game interesting and 
to make a second one is very easy now. We just 
need to duplicate the enemyl dictionary and call 
it enemy2, change the starting x and y to perhaps 
25, make calls to updateBall(enemy2) and 
updateEnemy(enemy2) in theupdateQ function 
and before you know it you have a second enemy 
ball. You could make as many as you like, or maybe 
put them in a list to be more efficient if there are 
more than three. 


A bit one-sided 

Now that we have baddies messing up our 
maze, it’s going to get pretty difficult for our player 
to get through to the finish, so it’s time to level 
the playing field, in this case quite literally. Let’s 
introduce some dynamite into the mix! We’ll need 
to make a tile graphic for the dynamite that we can 
use in the Tiled map editor, and also an icon that 
we can use to show how many sticks of dynamite 
the player has collected. If you want to use ready¬ 
made graphics and map data, they are available 
from the GitHub repo: magpi.cc/pgzeroio. 


Handling the explosives 

First, let’s add a variable to hold the number 
of sticks of dynamite being held by the player, 
which can be done by writing "dynamite": 0 as part 
of the player dictionary. Then, assuming that we 


figure3.py 

> Language; Python 3 

001. 

def updateEnemy(e) : 


002. 

edirs = [[-1,0],[0,1],[1,0],[0,-1]] 


003. 

if e["moveX ] == 0 and e["moveY ] == 0: 


004. 

r = randint(0,3) 


005. 

if doMove(e, edirs[r][0], edirs[r][l]) 

== 2: 

006. 

moveBlock(e["x"]+edirs[r] [0],e[ y"]+edirs[r] 


[1], edirs[r] [0], edirs[r] [1]) 


007. 

e[ sx ] = e["sy"] = 0 


008. 

else: 


009. 

if e["frame ] == 7 and e["movingNow"] 

== True: 

010. 

if e["sx' ] == 12: e["sx ] -= 32 


011. 

if e["sx' ] == -12: e["sx"] += 32 


012. 

if e["sy' ] == 6: e["sy"] -= 16 


013. 

if e["sy"] == -6: e[ sy ] += 16 


014. 



015. 

def moveBlock(mx,my,dx,dy) : 


016. 

if onMap(mx+dx, my+dy) : 


017. 

d = mapData[ 'data"] [my+dy][mx+dx] 


018. 

if d == 1: 


019. 

mapData ["data"] [my+dy][mx+dx] = 



mapData [lata ][my][mx] 


020. 

mapData ["data"] [my][mx] = 1 


▲ Updating the enemy ball and moving blocks if waLLs are in the way 


T The updated update( ) function to incLude two enemy baLLs 


figure4.py 

> Language: Python 3 

001. 

def updateQ: # Pygame Zero update function 


002. 

global player, timer 


003. 

mt = 0 


004. 

if player ["moveDone" ] == True: 


005. 

if keyboard.left: mt = doMove (player. 

-1, 0) 

006. 

if keyboard.right: mt = doMove(player, 

1, 0) 

007. 

if keyboard.up: mt = doMove(player, 0, 

-1) 

008. 

if keyboard.down: mt = doMove (player, 1 

0, 1) 

009. 

if mt == 4: 


010. 

mapData[ dati ][ player["y"] + player[ 

"queueY' ] ] [ 


player["x'] + player[ queueX"]] = 1 


011. 

player ["dynamite ] += 1 


012. 

updateBall (player) 


013. 

updateBall (enemyl) 


014. 

updateBall (enemy2) 


015. 

updateEnemy (enemyl) 


016. 

updateEnemy(enemy2) 
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amazeballs3.py 


have added some dynamite to our map data (see 
the previous part of this series for details on editing 
with Tiled), we need to detect if our player has 
moved onto a dynamite block and, if so, add 1 to our 
dynamite count and make the dynamite block into 
a floor block, which will make it disappear from the 
map. We can do this in our update () function. 


Stockpiling ammo 

To handle the picking up, we just need to 
test the value of mt after our keyboard checks. 
See figure4.py to view the revised update() 
function. When our player has picked up some 
dynamite, we can display the number held with 
icons, as we have done before (for example with 
lives), in the drawQ function by writing for 
1 in range(player["dynamite"]): screen. 
blit("dmicon", (650+(l*32),80)), which will 
draw our dynamite icons in the top right of the 
screen. So now we have the ammunition for our 
player to blow a path through the blockages that 
the baddies have put in the way. 


Going off with a bang 

All we have left to do now is to code a 
mechanism to set off the dynamite. We will 
do this with the Pygame Zero on_key_down() 
function. We need to test if the SPACE bar has 
been pressed and, if so, clear a space around the 
player, making all the blocks into floor blocks. 

This can be done with a nested for loop. Have a 
look at the full amazeballs3.py listing to see this 
last bit of code. 

Now is the time to test how the game is set up, is 
it too easy or too hard? Do you need more or fewer 
enemies? You could try making a range of different 
maps with other objects to collect. 


And finally 

Well, sadly that's all we have time for in 
this series. We hope you have learned a lot about 
Pygame Zero and writing games in Python. We 
must at this stage give a big shout out to the 
creator of Pygame Zero, Daniel Pope: without his 
excellent work, this series would not have existed. 
We hope you would agree that the Pygame Zero 
framework is an ideal starting place to learn game 
coding on the Raspberry Pi. E 1 


> Language: Python 


001. import pgzrun 

002. import map3d 

003. from random import randint 

004. 

005. player = { x":3, "y" :3, "frame" :0, "sx":0, "sy":96, 

006. "moveX":0, "moveY" :0, "queueX":0, "queueY":0, 

007. "moveDone" : True, "movingNow" : False, 

"animCounter" : 0, "dynamite" : 0} 

008. enemyl = { x" : 13, "y" :13, "frame" :0, "sx" :0, "sy" :0, 

009. "moveX":0, "moveY" :0, "queueX":0, "queueY":0, 

010. "moveDone" : True, "movingNow" : False, 

"animCounter" :0} 

011. enemy2 = {"x" : 25, "y" :25, "frame" :0, "sx":0, "sy":0, 

012. "moveX":0, "moveY" :0, "queueX":0, "queueY":0, 

013. "moveDone" : True, "movingNow" : False, 

"animCounter" :0} 

014. OFFSETX = 368 

015. OFFSETY = 300 

016. timer = 0 
017. mazeSolved = False 
018. 

019. mapData = map3d.loadmap("maps/mapl. json") 

020 . 

021. def drawQ: # Pygame Zero draw function 
022. screen. fill((0, 0, 0)) 

023. drawMapQ 

024. screen. blit ( 'title , (0, 0)) 

025. screen.draw. text ("TIME: "+str(timer) , topleft=(20, 

80), owidth=0.5, ocolor= (255,255,0), color=(255,0,0) , 
fontsize=60) 

026. for 1 in range(player["dynamite"]) : screen. blit ( 

"dmicon", (650+(l*32),80)) 

027. if mazeSolved: 

028. screen.draw. text ("MAZE SOLVED in " + str(timer) + 

seconds!" , center=(400, 450), owidth=0.5, ocolor=(0,0,0), 
color=(0, 255,0) , fontsize=60) 

029. 

030. 

031. def updateQ: # Pygame Zero update function 
032. global player, timer 

033. mt = 0 

034. if player[ 'moveDone ] == True: 

035. if keyboard.left: mt = doMove( player, -1, 0) 

036. if keyboard.right: mt = doMove( player, 1, 0) 

037. if keyboard.up: mt = doMove( player, 0, -1) 

038. if keyboard.down: mt = doMove( player, 0, 1) 

039. if mt == 4: 

040. mapData ["date ][ player ["y ] + player[ queueY"]][ 

player ["x ] + player ["queueX ]] = 1 
041. player ["dynamite"] += 1 

042. updateBall(player) 

043. updateBall(enemyl) 

044. updateBall(enemy2) 

045. updateEnemy( enemyl) 

046. updateEnemy(enemy2) 

047. 

048. def on_key_down(key) : 

049. if player ["dynamite ] > 0 and key.name == "SPACE": 

050. player ["dynamite ] -= 1 

051. for x in range(player["x ]-l, player["x' ]+2): 
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DOWNLOAD 

THE FULL CODE: 



magpi.cc/pgzero10 



052. 

for y in range (player ["y ]-l, player[ 'y' ]+2) : 

104. 


053. 

mapData["data' ][y] [x] = 1 

105. 

def updateEnemy(e) : 

054. 


106. 

edirs = [[-1,0],[0,1],[1,0],[0,-1]] 

055. 

def timerTickQ: 

107. 

if e["moveX"] == 0 and e ["moveY 1 ] == 0: 

056. 

global timer 

108. 

r = randint(0,3) 

057. 

if not mazeSolved: 

109. 

if doMove(e, edirs[r][0], edirs[r][l]) == 2: 

058. 

timer += 1 

110. 

moveBlock(e["x ]+edirs[r] [0],e["y ]+ 

059. 



edirs[r][l],edirs[r][0],edirs[r][1]) 

060. 

def drawMapQ: 

111. 

e[ 's: ] = e["sy"] = 0 

061. 

psx = OFFSETX 

112. 

else: 

062. 

psy = OFFSETY-32 

113. 

if e[ "frame"] == 7 and e["movingl\low ] == True 

063. 

mx = psx - player ["sx"] 

114. 

if e["sx"] == 12: e["sx"] -= 32 

064. 

my = psy - player ["sy"] +32 

115. 

if e[ sx ] == -12: e["sx"] += 32 

065. 


116. 

if e["sy ] == 6: e["sy ] -= 16 

066. 

for x in range(player[ :"]-12, player[ x"]+16): 

117. 

if e[ sy ] == -6: e["sy"] += 16 

067. 

for y in range(player["y ]-12, player ["y" ]+16) : 

118. 


068. 

if onMap(x,y): 

119. 

def moveBlock(mx,my,dx,dy) : 

069. 

b = mapData[ ]ata'][y][x] 

120. 

if onMap(mx+dx, my+dy): 

070. 

td = findData(mapData[ tiles" ], "id", b) 

121. 

d = mapData["data"] [my+dy][mx+dx] 

071. 

block = td[ "image 1 ] 

122. 

if d == 1: 

072. 

bheight = td[ Lmageheight"]-34 

123. 

mapData[ "data"] [my+dy][mx+dx] = 

073. 

bx = (x*32)-(y*32) + mx 


mapData[ 'dat; ][my][mx] 

074. 

by = (y*16)+(x*16) + my 

124. 

mapData["data"] [my][mx] = 1 

075. 

if -32 <= bx < 800 and 100 <= by < 620: 

125. 


076. 

screen. blit (block, (bx, by - 

126. 

def updateBall(p) : 


bheight)) 

127. 

if p["movingNow"] : 

077. 

if x == player [ x"] and y == player [ ]: 

128. 

if p[ moveX"] == -1: moveP(p, -1, -0.5) 

078. 

screen, blit ("baH"+str (player [ 

129. 

if p[ moveX"] == 1: moveP(p,l,0.5) 


"frame"]), (psx, psy)) 

130. 

if p["moveY"] == -1: moveP(p,l, -0. 5) 

079. 

if x == enemyl[ 'x' ] and y == 

131. 

if p[ moveY"] == 1: moveP(p, -1,0.5) 


enemyl[ ] • 

132. 

p["animCounter ] += 1 

080. 

screen. blit ("eball"+str(enemyl[ 

133. 

if p[ animCounter"] == 4: 


"frame"]), (bx + enemyl["sx"], (by-32)+enemyl[ sy ])) 

134. 

p["animCounter ] = 0 

081. 

if x == enemy2['x'] and y == 

135. 

p[" frame ] += 1 


enemy2["y"]: 

136. 

if p[ "frame"] > 7: 

082. 

screen. blit ("eball"+str(enemy2[ 

137. 

p ["frame ] = 0 


"frame"]), (bx + enemy2["sx"], (by-32)+enemy2[ sy ])) 

138. 

if p["frame"] == 4: 

083. 


139. 

if p[ "moveDone ] == False: 

084. 

def findData(lst, key, value): 

140. 

if p[ queue> ] != 0 or p["queueY"] !=( 

085. 

for i, die in enumerate(lst) : 

141. 

p.update({ "moveX" :p[ queueX"], 

086. 

if die [key] == value: 


"moveY":p[ ’queueY"], "queueX":0, 'queueY":0, 

087. 

return die 


"movingNow": True}) 

088. 

return -1 

142. 

else: 

089. 


143. 

p.update({ "moveDone" : True, "moveX" :0, 

090. 

def onMap(x,y): 


"moveY" : 0 , "movingNow" : False}) 

091. 

if 0 <= x < mapData[ "width ] and 0 <= y < 

144. 



mapData[ ’height"] : 

145. 

if p[ "frame"] == 7 and p[ ’moveDone"] == False 

092. 

return True 


and p[ "movingNow"] == True: 

093. 

return False 

146. 

p["x ] += p["move> ] 

094. 


147. 

p["y ] += p[ "moveY"] 

095. 

def doMove(p, x, y): 

148. 

p[ "moveDone"] = True 

096. 

global mazeSolved 

149. 


097. 

if onMap(p["x"]+x, p[ y"]+y): 

150. 

def moveP(p,x,y) : 

098. 

mt = mapData["data"][p["y"]+y][p["x ]+x] 

151. 

p["sx"] += X 

099. 

if mt == 1 or mt == 3 or mt == 4: 

152. 

p["sy ] += y 

100. 

p.update({ "queueX" :x, "queueY" :y. 

153. 



"moveDone" : False}) 

154. 

clock. schedule_interval(timerTick, 1.0) 

101. 

if mt == 3 and p == player: 

155. 

pgzrun.go() 

102. 

mazeSolved = True 



103. 

return mt 
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ARCADE 

PR03ECTS 


INSPIRING PROJECTS 
AND STEP-BY-STEP BUILDS 


120 MINI LUNCHBOX ARCADE 

Marvel at this mini retro arcade in a box 

122 4D ARCADE MACHINE 

Raspberry Pi-powered game with 
extra interactive elements 

126 BUILD A 

PORTABLE CONSOLE 

Create the ultimate retro handheld 
with PiGRLL 2 

140 MAKE YOUR OWN 
PINBALL MACHINE 

Build a table with this step-by-step guide 

146 BUILD AN 

ARCADE MACHINE 

Make your own retro cabinet 
with Raspberry Pi 


□ Build your own perfect and 
brand new arcade emulation 
machine with Raspberry Pi □ 
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SHOWCASE 



It’Ll run for about an 
hour per charge 

> Build details 
can be found at 

magpi.cc/2nwQUE 

> Daniel is working on 
four new Pi projects 


Mini Lunchbox Arcade 



Daniel 

Davis 


Daniel is a retro- 
modern perpetuaL 
beta tester who is 
an IT specialist by 
day and a YouTuber 
by night. He Lives to 
Learn and Loves 
to tinker. 

tinknernut.com 


Never mind □ packed lunch, have a fun-packed lunchtime 
with this mini retro arcade in a box, By Phil King 


H aving already built a full-size tabletop-style 
arcade cabinet powered by a Raspberry Pi, 
Daniel Davis wanted to make something a little 
more portable to feed his passion for retro gaming. So 

when he acquired an old metal lunchbox, the last thing 
on his mind was using it to store sandwiches. Instead, 
he opted to pack it with a retro arcade system built 
using a Raspberry Pi 3, Adafruit Backpack 5-inch HDMI 
touchscreen, Adafruit Arcade Bonnet, speaker, plus an 
analogue joystick and mini arcade buttons. 

“The challenge was sourcing arcade buttons 
and components that would fit,” says Daniel. “For 
instance, standard-sized arcade buttons were too 
large to fit inside. I also had to take into consideration 
the depth of the screen so that when the lid closed, it 
didn’t smash into any of the other components.” 

Neat and tidy 

Rather than simply cramming components into the 
box, Daniel wanted to make the system organised and 
easy to use, “so that anyone could open it up and be 


familiar with the control layout (which mimics that 
of a classic games console controller).” 

To keep everything looking secure, and hide 
the wiring, Daniel 3D-printed a screen holder 
and controller board that he’d designed in a CAD 
program. “Once I had all the components laid out, 

I did a couple of test prints to make sure everything 
fit, but then I realised that I hadn’t designed 
anywhere for the wires to go (especially for the 
screen). So I had to go back and redesign the casing 
to allow room for the various wiring. ” 

Daniel recalls that a lot of time was spent 
measuring, testing, and measuring again. “I went 
through several different types of arcade buttons 
before I found ones that did the job and fit in such 
a small space.” 

Ensuring that the control panel was low enough 
to allow enough room for the screen when the 
box was closed was another crucial factor: “If the 
lunchbox couldn’t close properly, it defeated the 
whole purpose of the project.” 


Mini Lunchbox Arcade 








































SHOWCASE 



Arcade experience 

Daniel tells us that his previous experience of 
building an arcade cabinet in 2013 helped when 
approaching this smaller project. Since then, the 
build process has become a lot easier, thanks to the 
availability of various Raspberry Pi HATs and bonnets 
which a made everything a breeze to connect. Aside 
from that, the available software for the Pi to make 
arcade emulation possible is also something that has 
become a lot better over the years.” 

Daniel spent about 20 hours, spread over several 
weeks, to complete the build. The end result is a 
cute and compact arcade system that’s simple to 
pick up and play (youtu.be/h8nhqowESKg). 

Upon being shown the Mini Lunchbox Arcade, 
Daniel’s nephew was <c really shocked to see what 
was inside. He was able to immediately figure out 
how to turn it on and start playing a game. He did 
say that if I could find a way to sell them, all of 
his friends would buy one and I’d make a million 
dollars. That’s quite the endorsement!” EH 


▲ The system runs the 
RetroPie retro gaming 
OS on a Raspberry Pi 3. A 
software fix was required 
to ensure the interface 
filled the screen 


T The joystick, arcade 
buttons, and mini 
speaker were hot-glued 
to Daniel's 3D-printed 
controller board 



Filling a lunchbox 




One obvious problem with using a metal box 
is its conductivity, so to avoid any possibility 
of short circuits, Daniel Lined it with Kaplon insulating 
tape before adding the electronics. 


The analogue thumb joystick, six buttons, 
and 0 . 25 W 8 Q speaker were connected to an 
Adafruit Arcade Bonnet. A couple of freely available 
scripts were then run to get everything working. 



After careful measuring, Daniel designed and 
3 D-printed a screen holder, which he hot-glued 
to the Lunchbox Lid, and a board to house the arcade 
controls and speaker. 
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4D Arcade Machine: 

Can't Drive This 


r - 


nr 


► This two-pLayer 
co-operative game 
involves one pLayer 
building the track whiLe 
the other drives along it 






Machine creator Pixel 
Maniacs usually makes 
PC and console games 


SHOWCASE 


A Raspberry Pi-powered arcade display with hidden 
interactive controls won over the crowds at Gamescom. 

Rosie Hattersley and Rob Zwetsloot got the inside scoop 


Pixel Maniacs 


Pixel Maniacs is a 
Nuremberg-based 
games maker that 
started out making 
mobile apps. These 
days it specialises 
in games for 
modern video game 
consoles and PC 
computers. You 
Can't Drive This is 
its first foray into 
gaming with a 
Raspberry Pi. 

pixel-maniacs.com 


I f you’re going to add a little something extra to 
wow the crowd at the Gamescom video games 
trade fair, a Raspberry Pi is a surefire way of 
getting you noticed. And that’s the way Pixel Maniacs 
went about it. 

The Nuremberg-based games developer retrofitted 
an arcade machine with a Raspberry Pi to showcase its 
intentionally silly Can’t Drive This precarious driving 
game (magpi.cc/TphZao) at Gamescom. 

Complete with wrecking balls, explosions, an 
inconvenient number of walls, and the jeopardy 
of having to construct your road as you negotiate 
your way, at speed, across an ocean to the relative 
safety of the next lump of land, Can’t Drive This 
is a fast-paced racing game. 

Splash action 

Pixel Maniacs then took things up a notch by 
providing interactive elements, building a mock 
4D arcade game (so-named because they feature 
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The 1980s arcade 
machine was 
originally destined 
for the dump 


Several Gamescom 
attendees tried to 
buy the project on 
the spot 


Players receive 
a customised 
memento of 
them playing on 
the machine 


The company’s 
first game was 
puzzle-shooter 
ChromaGun 


The team’s next 
project sees 
them play around 
with time 
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▲ Replacing the original 
1980s kit with modern- 
day processors 
and Raspberry Pi- 
powered additions 


► The schematic for the 
4D arcade machine, 
showing the importance 
of Raspberry Pi as 
a controller 




► Having played your 
heart out you get a 
photo-booth-style 
shot of you in full-on 
gaming action 



YOUR SCORE 

7824 

24 . 06.2013 16:58 
Loot Pickup a I 6 


interactive elements such as motion cabinets). 

The fourth dimension in this case saw the 
inclusion of a water spray, fan, and console lights. 
For its Gamescom debut, Pixel Maniacs presented 
Can't Drive This in a retro arcade cabinet, where 
hordes of gaming fans gathered round its four-way 
split screen to enjoy the action. 

Adding Raspberry Pi gaming to the mix was 
about aiding the game development process as 
much as anything. Andy Holtz, Pixel Maniacs' 
software engineer, says the team wanted an LED 
matrix with 256 RGB LEDs to render sprite-sheet 
animations. “We knew 
we needed a powerful 
machine with enough 
RAM, and a huge 
community, to get the 
scripts running." 


Raspberry Pi 


Power Supply 


RGB LED MATRIX 
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WATER 
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Pixel Maniacs' offices have several Raspberry Pi- 
controlled monitors and a soundboard, so the team 
knew Raspberry Pi's potential. 

The arcade version of the game runs off a 
gaming laptop cunningly hidden within the walls 
of the cabinet, while a Raspberry Pi delivers 
the game’s surprise elements such as an 
unexpected blast from a water spray. A fan 
can be triggered to simulate stormy weather, 
and lights start flashing crazily when the cars 

crash. Andy explains that 
the laptop “constantly 
sends information 


B588& 

rrr Bayern 


9 




about the game's state 
to Raspberry Pi, via a 
USB UART controller. 
[Raspberry] Pi reads 
these state messages, 
converts [them], 
and sends according 
commands to the fans, 
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water nozzle, camera, and the LED light matrix. So, 
when players drive through water, the PC sends 
the info to [Raspberry] Pi, and [the latter] turns on 
the nozzle, spraying them.” 

The arcade idea came about when Pixel Maniacs 
visited the offices of German gaming magazine 
M! Games and spied an abandoned, out-of-order 
1980s arcade machine lurking unloved in a corner. 
Pixel Maniacs set about rejuvenating it, Da Doo Ron 
Ron soundtrack and all. 


▲ Pixel Maniacs 
reprogrammed a 
handheld games 
console controller for 
the arcade machine 


Sustained action 

Ideas are one thing; standing up to the rigours of 
a full weekend’s uninterrupted gameplay at the 
world’s biggest games meet is something else. 
Andy tells us, “Raspberry Pi performed like a beast 


□ Raspberry Pi delivers the game's surprise 
elements such as an unexpected blast from 
a water spray □ 


throughout the entire time. Gamescom was open 
from 9am till 8pm, so it had to run for eleven 
hours straight, without overheating or crashing. 
Fortunately, it did. None of the peripherals 
connected to [Raspberry] Pi had any problems, and 
we did not have a single crash.” 

Fans were enthusiastic too, with uniformly 
positive feedback, and one Gamescom attendee 
attempting to buy the arcade version there and 
then. As Andy Holtz says, though, you don’t sell 
your baby. Instead, Pixel Maniacs demonstrated 
it at games conventions in Germany in autumn 
2018, before launching Can’t Drive This across 
gaming platforms. ED 


SHOWCASE 


Arcade gaming reimagined 



A Raspberry Pi 3B+ was used to trigger the 
water spray, Lights, and fans, bringing an extra 
element to the gameplay, as well as rendering the 
arcade machine’s graphics. 



The transformation from a decidedly unloved- 
looking eighties console to a modern 4D 
gaming machine owes a great deal to the team's 
imagination, as well as the additions Raspberry Pi 
made possible. 
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Can't Drive This is every bit as engaging and 
frustrating to play as other driving arcade games, 
but this one comes with the unexpected jeopardy of 
getting blasted with water for your troubles. 
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Build upon Adafruit's amazing PiGRRL 2 using a Raspberry 
Pi Zero W to create the ultimate retro handheld console... 


ortable gaming has been hugely 
popular ever since the the late 
eighties. Building on the work of 
earlier LCD games, the 1980s handhelds 
allowed you to take one machine 
wherever you went. They played a 
multitude of games via handy cartridges 
filled with code, including portable 
versions of video game classics. 

Since then, handheld gaming and 
computers have evolved. Mobile 
phones have become a great source 
for providing quick hits, while games 
companies go all out with handheld 
systems that contain ultra-powerful 
components. On the computing side, 
processing power has advanced to such 
a degree that Raspberry Pi is powerful 


"1 

enough to emulate several popular retro 
home consoles, while also being small 
enough to carry around. 

This is why the PiGRRL projects 
from Adafruit are popular: handheld, 
old-school consoles you can use on the 
go. There are many versions of them, 
based on everything from original models 
of Raspberry Pi to Raspberry Pi Zero. 

With Raspberry Pi Zero W, these 
projects can go even further thanks to 
the built-in wireless LAN, and it also 
leaves more space for a bigger battery. 

And a bigger battery means longer play 
time. In this guide, we're going to show 
you how to take the PiGRRL 2 and do just 
this. Grab your work dungarees and let's 
go build a games console! 





Build a portable console 
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YOUR PRRTS 

Here’s what you’ll need to make the Pi GRRL Zero W 



<X\\\, 2 \\ 

Raspberry Pi Zero W 


> magpi.cc/pizerow < 

The key to this project is Raspberry Pi Zero W, or 
Raspberry Pi Zero WH (magpi.cc/zerowh) which comes 
with the GPIO pins attached. This board saves a load 
of space thanks to the radio chip included in it, so no 
WiFi dongle is needed. It runs at lGHz, which makes it 
powerful enough to run many emulators. 




TOOLS 

FOR THE JOB 

Soldering iron 
Wire 

Heat shrink 
Glue 
Blu Tack 
Wire strippers 
Hobby knife 



> magpi.cc/2kS9Klf < 

The PiGRRL 2 case repurposed for our needs. 

It has some spaces for USB and Ethernet on a 
Raspberry Pi full-size board, but a Raspberry Pi 
Zero will require extensions if you want to make 
use of the gaps. 




RdaPruit 
PiTFT 5.8” 


> magpi.CC/2l0b5Ky < 

This is actually a touchscreen, although 
we won’t be making use of it in that way. 
It fits neatly in the case and provides 
four extra buttons to use when playing 
games. You can also assign system and UI 
shortcuts to the buttons. 
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PiGRRL S 
controller 
board ^ 

> magpi.CC/2LohZzr < 

This Custom Gamepad PCB is 
designed to fit the case perfectly. 
We did try to see if a standard 
USB PCB would fit inside, but 
they were far too big. 


Microswitches 

> magpi.CC/ 2 lo 890 i < 

The beauty of proper retro gaming is tactile 
controls. YouTl need ten 6mm switches, 
and a couple of 12mm buttons. 


SCREWS 

A selection of 
screws to attach 
the parts to the 
case. This includes 
14* #4-40 and 
6* #2-56 3/8 
machine screws. 


Bluetooth audio (optional) 

There's no dedicated Audio Out on the Pi Zero W, but it 
does have Bluetooth and RetroPie supports Bluetooth 
audio. Get a pair of Bluetooth headphones and take a 
look at this tutorial: magpi.cc/e9cypq 


M 


Slide switch 


> magpi.CC/ 2 L 05 aFg < 

This is one of the cool bits: we're going 
to use this PowerBoost to actually charge 
a battery within the handheld. With the 
low power draw of Raspberry Pi and 
advancements in modern battery tech, 
you'll get a lot out of one charge. 


GPU hammer 
headers 


> magpi.CC/2L0hN2U < 


2500 mRH 
battery 

> magpi.CC/2lQzVmr < 

We squeezed the biggest battery into 
here that we possibly could. This way, 
it should last for hours and hours. 


A wonderful innovation, these GPIO 
headers require zero soldering and 
can be (carefully) hammered 
onto the empty pins 
of a Raspberry Pi Zero. 


> magpi.cc/2L0jfTb < 

This switch allows you to turn the power 
on and off. It's best to do the software 
shutdown of RetroPie first before 
switching the power off, though. 


PowerBoost 

1000C 
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PRINT THE CRSE 


What you need to know about 3D-printing the Pi GRRL 2 case 

— •>. >1 a 


T he proliferation and advancement of 3D 
printing has been a huge boon for the 
maker community, enabling you to create 
wonderful chassis and cases for your final products. 
The PiGRRL series has a number of cases built 
around Raspberry Pi that allow for maximum 


HOW TO PRINT 
YOUR 3D QRSE 


efficiency in size, while also allowing for a fully 
operational handheld. 

For this project, we're going to make use of the 
slightly larger PiGRRL 2 case for maximum comfort, 
and also so we can use the extra space to install a 
bigger battery into it. Here's how to make your own 


PiGRRL 2 - Raspberry Pi Game Console 


>STEP-01 

GET THE FILES 

The full PiGRRL 2 case files can be 
downloaded from magpi.cc/2kS9K1f, 
although there are more files here than 
what you actually need to print. The ones 
you'll need from the pack are: 


>STEP-02 

FIND R 3D 
PRINTER 


It can be tricky to find a good 3D printing service 
online, so unless you have access to a 3D printer, we 
highly recommend using 3DHubs.c0m. It lists local 3D 
printing services, along with an estimated completion 
time and reviews. The files we downloaded also work 
with the service. 


pigrrL2-top.stl 

pigrrL 2 -b 0 t.sU 

pitft-buttons.stL 

dpad2.sU 

action-btns.stl 

pause-start.stL 

shoulder-btns.stl 

shoulder-mount.stL 



Where 3D prints are made 

hind tho right 30 printing smvilco for your nr?Kt project 



GET THE FILES AT 


magpi.cc/2kS9K1f 


Browse 3D printing sejvil 


658,611 

fi-j-ii- printed 


48 hours 

fai) (urruHOuiid mi 


3D HUBS 3D Print- Learn- 


USE 3DHUBS.COM 


to print your case! 





>STEP-03 

er 


UPLORD FILES 

tup Costs 

£2-99 

Once you've selected your printer, you'll be asked to upload 

Lhoulder'btns.sti 

£0.41 

the files. Double-check you've selected the correct ones and 
make sure they upload properly - you'll get an error if they fail. 

13 X12 X OS cm 

Quantity: \ 

Usually, trying again will work. You also only need one of each, 

?igrrl2-bot.stl 

£9.16 

and ABS or PLA are great materials to use for the parts. 

41X 9,1X1.9 cm 

Quantity; l 
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GET RRSPBERRY PI 


Get your Raspberry Pi Zero W ready to be made into a retro gaming treasure 


The configuration screen starts by asking 
about your current controller setup 



®xj 

@Y}@A) 



When you come back to reconfigure your buttons, refer to this handy guide 


"W. ■ -W- 


SETTING UP WIRELESS 

Wireless connectivity on Raspberry Pi Zero W is great, but the 
configuration method for wireless LAN on the RetroPie is very 
basic. You’ll need to know the name of your wireless network 
(SSID) along with the password, as it won’t be able to search for 
available networks. You can also import details by loading a .txt 
file onto the boot partition. 



Configure UiFi 

Current IP: 102.166.6.106 

Wireless ES51D: 


nnect to UiFi lietuor 


2 Disconnect/Renoue UiFi conftg 

3 Import wifi credentials fron /loot/uifikeyfile.txt 


< Help > 




F or this project, we’re using the excellent 
RetroPie to power our emulation software. 
You’ll first need to download the image for 
RetroPie from its website here: magpi.cc/25UDXzh. 
Write it to a microSD card and pop it into your 
Raspberry Pi Zero W. Get that hooked up to a monitor 
along with a keyboard, and we can get it ready. 

You’ll first need to map some buttons - as the PCB 
controller isn’t hooked up yet, we’ll have to quickly 
use the keyboard for the initial setup. Make sure the 
directional keys, Start, Select, A, and B are assigned a 
key and just hold down the space bar to skip anything 
else. Once that’s done, connect to the wireless using 
the info in the ‘Setting up wireless’ boxout. 

To get our final build working, we need to make 
sure to install support for the PiTFT, as it’s not 
supported natively. SSH into your Raspberry Pi 
Zero W at retropie.local or press F4 to enter the 
command line on RetroPie, and enter the following: 


cd 

curl -0 https://raw.githubusercontent. 
com/adafruit/Raspberry-Pi-Installer- 
Scripts/master/pitft-fbcp.sh 
sudo bash pitft-fbcp.sh 


Select PiGRRL 2 and don’t reboot. Now we need 
to add support for the custom buttons. Back in the 
command line, use: 


cd 

curl -0 https://raw.githubusercontent. 
com/adafruit/Raspberry-Pi-Installer- 
Scripts/master/retrogame.sh 
sudo bash retrogame.sh 


Select PiGRRL 2 again and then reboot the system. 
Once we’ve put all the parts together, and before 
it’s assembled in the case, we’ll need to configure 
the controls for the buttons we’ve made and added 
to the project. Press the button assigned to Start 
and select Configure Input, and then go through the 
configuration process again. 
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BUILD THE SYSTEM 



>STEP-01 

PREPARE THE 
GAMEPAD BOARD 

Our first job is to solder the header pins onto the 
Gamepad board. You can keep it all in place with a 
little Blu-Tack before soldering it on. Make sure you’re 
soldering the header onto the correct side of the board. 


KLIGHT 

oesn’t have its backlight 
• take a craft knife and cut the 
>cks in the #18 box that you can 
re. 


Follow along and build your retro handheld 


>STEP-02 

ADD THE 
BUTTONS 


Now it s time to carefully solder 
the ten 6 mm microswitches 
to the front of the board. 

Some helping hands would 
be good here. 
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>STEP-04 


It’s a good idea to shorten 
the ribbon cable. 108mm is 
apparently the perfect size, but 
you can go a little longer. Once 
you’ve measured it, cut the cable. 




>STEP-0B 

PREPARE 
FDR POWER 

To make all our soldering easier, weTl dab some 
solder onto the spots where we need it for the 
moment. On the PowerBoost 1000C, add some 
solder to the positive and negative pins, and the 
EN and GND pins. Cut one of the legs off the power 
switch and put some solder on the other two. 


>STEP-05 

ASSEMBLE 
THE CABLE 


Using something like a pen or pin, youTl need to push 
in the clip that holds the connector in place on the 
part you’re discarding. Very carefully remove the cable 
and install it at the end of your newly trimmed cable. 
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^CjFiGRRL 


Make sure the power switch will fit in the hole for it in the case - it’s on 
the side of the bottom part. You may need to file away the plastic a bit. 
Once that’s done, trim two short bits of wire to about 7 cm long and solder 
one to each leg. Solder those to EN and GND - it doesn’t matter which way 
around they go. 


>STEP-0B 

SHOULDER 

BUTTONS 


The shoulder buttons (the 12 mm ones) need to 
be attached to the controller board much like the 
switch was connected to the power board. Clip two 
legs off each and use a pair of pliers to flatten the 
remaining two. Solder wires to each pin (about 14cm 
long) and then solder the other end to the bumper 
pins on the controller board. Again, polarity doesn’t 
matter, but keep each one as a pair in the row. 




>STEP-01 

SOLDER ON THE SWITCH 


>STEP-03 

WIRE IT 
FILL UP 



Now we can combine the power 
with the controller board, which 
will allow us to provide power 
to the whole system. Solder two 
wires (about 14 cm long) to the 
underside of the 5 V and GND pins 
on the controller board. The 5 V 
wire should then be soldered to the 
positive of the PowerBoost board, 
with the GND to the negative. 





SB 

sUSI 

si 

in 
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>STEP-13 

CLOSE IT UP 

Now you can finally close it up! Insert 
the battery and tape it down if need 
be, before screwing it shut. Make sure 
all the cables are safely inside the case 
before tightening it, though! 


WHNT 
TO KNOW 
MORE? 

Prefer to use a 
full-sized Raspberry Pi? 
Check out the original 
PiGRRL2 guide: 

magpi.cc/2L0ALzQ 


>STEP-11 

BEGIN CONSTRUCTION! 


Take the top of the case and insert all the button 3D prints. Once that’s 
done, insert the screen and screw it in, followed by the controller board. 
Finish up the top bit by connecting the two with the ribbon cable, and 
then insert your Raspberry Pi Zero into the header on the PiTFT. 


>STEP-12 

BRCK PLRTE 


YouTl now need to mount the back buttons and 
the PowerBoost. The rear buttons have a plate 
that keeps them in place, and Adafruit suggests 
using a little Blu-Tack to stick the switches in 
position. YouTl attach the power switch and then 
finally screw on the PowerBoost. Be careful with 
the wires that you’ve soldered on. 


It’s now a good idea to add the GPIO 
headers to Raspberry Pi Zero W. Gently 
hammer them in until they’re secure, 
and you’re done. 


— 


At this point you can test the 
entire system, otherwise we'll 
move onto final construction... 


>STEP-10 

HRMMER 
THE HERDS 
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PIGRRL 


Here’s some of the advantages of having the 
PiGRRL powered by Raspberry Pi Zero W 


CONNECT 
VIR SSH 

Physically connecting to a Raspberry Pi Zero inside is a massive 
hassle once the case is screwed together. With Raspberry Pi Zero W 
connected to your home network, though, it’s easy to connect to it 
remotely from another computer using SSH. 

On a macOS or Linux machine (which includes another Raspberry 
Pi!), you can simply open the terminal or command line and enter the 
following to connect: 


ssh pi@retropie 


It will prompt you for a password, which (by default) is raspberry. 
The username in this instance is pi, with retropie being the default 
name for the system on the network. 

For Windows machines, youTl have to connect using an SSH 

application like PuTTY 


Ease Gffcris btiraj- PuTTY tecson 
£{Pk 6 tha derthSiwi you wertin «mtd la 


You can ignore a Lot of the PuTTY interface 
when just connecting to the handheld 


(magpi.cc/2lBHCRm). Once 
it’s installed, you need to set 
the host name to retropie, 
the port to 22, and then click 
Open. YouTl need to put 
in pi as the username and 
raspberry as the password. 

Once inside, you can control 
many aspects of the system 
via the command line. If 
you’ve used the terminal in 
Raspbian, youTl know how it 
works: sudo reboot, Is, cd, etc. 



x 


_ Retr^pie-Setiip Script 

version: 4.6 

Lest Commit: 20 minutes ago !0ea0e&9l 


! BHRmuhap 

p manage packages 
C Configuration / tWU 
s update Retrop-ie-setup script 
x Uninstall RetroPifl 
Ft Perform reboot 


: Help S 


UPDRTING 

RETROPIE 

You can update RetroPie from the handheld itself 
or via SSH in the command line. The keyboard 
might be better suited for this, so if youTe by your 
computer it wouldn’t hurt to use it instead. 

From the handheld, you need to go to the 
RetroPie menu in EmulationStation and activate 
the setup script. From the terminal (if you’ve 
SSHed in), you can use the following command: 


sudo ~/RetroPie-Setup/retropie_setup.sh 


From here, look for the ‘Update All Installed 
Packages’ option. There are many options here 
that you can select from, including managing the 
individual packages in case you want to remove 
or add any. To update, you can select the option 
‘Update all installed packages’ (which will also 
update the RetroPie-Setup script as well) or 
you can go to ‘Manage packages’ and update the 
packages individually. This could be useful if any 
packages have some problems updating, or if you 
want to do the essential updates before running 
out the house. 
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If you want to upload ROMs to the handheld, 
you can do so with Raspberry Pi Zero W’s 
wireless connection. Otherwise, you’d have to 
manually load them onto the microSD card, 
which would require dismantling the console to 
get to your Raspberry Pi Zero - not particularly 
easy or practical to do. Luckily, RetroPie 
includes Samba and SFTP, which allow you to 
transfer the files over the network. 

For Samba it’s nice and easy: when your 
handheld is connected to your network, you 
can go to your main computer and find it on 
the network shares as \\RETROPIE. Here you 
can upload any necessary extra files to the 
handheld with minimal hassle. 

For SFTP you’ll have to make use of 
special software. For Windows, the 
RetroPie team recommend WinSCP 
(magpi.cc/2lCwRhz); for macOS, you can try 
Cyberduck (magpi.cc/2lCwjs9). 

Once booted up, you can use the same SSH 
settings as we used for PuTTY. You can then 
drop the files into the corresponding folder in 
the roms directory. 


System: snes 
Emulator: ir-snessx-next 
video node: 

ROM: rtasK, The (U) 


PLRYING 

ONLINE 


Otherwise known as netplay in emulation circles, this allows you to 
play multiplayer games with friends, even if they’re on the other side 
of the world! Not every emulator supports it and if it does, you need 
to follow three extra rules: both parties need to be running the same 
version of RetroArch, both must be running the same emulator, and 
both need to be running the same ROM. 

You then need to configure netplay from the setup script. If you’re 
hosting, change your Netplay Mode to host, make the host IP your IP 
address, and pick a nickname. The client (other player) needs to go to 
the same menu, change Netplay Mode to client, change the host IP to 
the other handheld, and pick your nickname. You may need to open up 
a specific TCP/UDP port on the host’s router, which you then need to 
set as the same on both systems. 

Now both of you need to open the same ROM using the ‘jso’ key 
(which should be X on a classic controller layout) and select ‘Launch 
with netplay enabled’. If it’s been set up correctly, you’ll connect! 



Eg' Nftw&te 
□ noot$tf2rlfi3-Q 110 


;elect default emulator for sues (ir-snesSx-next] 


z select emulator for rom 0 

4 Select default video mode for lr-snes9x-next 0 

5 Select video mode for Ir-snesSx-next + rom O 
8 select Retraftreh render res for ir-snesSx-next (640 
3 Edit custom Retrench config for this rom 
x Launch 

Q Exit (without launching) 

Z Launch with netplay enabled 






CAUTION! 


PIRATING VIDEOGAMES IS BAD, 
NOT TO MENTION ILLEGAL! 

Don’t use illegally downloaded 
content on your PiGRRL. 

magpi.ee/legalroms 


p:i 


Session 


|sFTP 




tfMEnomer 


Port number: 


username; 


Password: 


Save ]▼ ( Cancel. ) | Advanced... ]»] 


Manage 


[5] logn | Pose | Hefr 
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MEET THE 


RUIZ BROTHERS 


We talk to the original creators behind the Pi GRRL and many other amazing Adafruit projects 


PIGRRL HISTORY 

How the PiGRRL project has evolved 


PIGRRL 


The original PiGRRL used the original Raspberry Pi 
Model B to power it. It’s a lot bigger than the version 
we’re building, although it more accurately matches 
the size of an original handheld console. 


T wo of the superstars of the maker scene are Noe Ruiz and 
Pedro Ruiz, otherwise known as the Ruiz Brothers. TheyVe 
done many amazing projects for Adafruit, including a lot of 
3D printing and wearables, which always go down well with the 
community. So it’s surprising to hear they’ve only been in the 
maker scene for about five years. 

“My brother and I purchased our first 3D printer in 2012 and 
quickly started using it in our work,” Noe tells us. “While looking 
for a way to integrate lighting into our 3D-printed designs, we 
discovered Adafruit and the Arduino platform. We built some 
projects using their parts and came up with some unique ideas. 
We went on Adafruit’s weekly live show-and-tell show, and the 
rest is history.” 

What started off as a load of cool hacks that added LEDs to 
existing products or enabled you to create great light-up projects 
quickly evolved into doing more. Part of this was to do with the 
introduction of Raspberry Pi. 

“Our first project with Raspberry Pi was the DIY Wearable Pi 
with Near-Eye Video Glasses,” explains Noe. “We were interested 


PIGRRL S PIGRRL ZERO 1 

This should look familiar - this is the version we’ve The latest version of the PiGRRL is a tiny device, 

based ours on! It’s an upgrade over the PiGRRL as reminiscent of ultra-tiny gaming consoles. It uses 

it uses a lot more custom components, including a a Raspberry Pi Zero and a series of other small 

custom PCB for the controls instead of a repurposed components, all squeezed into a tiny little 3D-printed 

board. You could easily switch a Raspberry Pi 3 or 4 case. Raspberry Pi Zero is still powerful enough to 

in there if you wanted a bit more power. run a lot of emulators, though. 
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ENERGY 5WGRD 

> magpi.cc/2lKKSWC < 

This one isn’t a completely custom build - instead, 
it’s an upgrade/customisation of a pre-existing 
energy sword toy. The Ruiz Brothers took the already 
pretty cool design and added a ton of NeoPixels to 
make it pulse with energy, similar to how fururistic 
swords look in games. 


NEOPIXEL YOYO 

> magpi.CC/2LKRd4c < 

A simple playground toy turned awesome with the use of 
some NeoPixel LEDs. The yoyo itself is also 3D-printed, 
allowing for custom parts so that you can fit the 
electronics inside. It even has a USB charging port. Check 
out the link for some cool GIFs of the yoyo in action. 


in Google Glass and thought we’d make a DIY version with n 
Raspberry Pi. We hacked apart a pair of video glasses, and designed 
a custom 3D-printed housing for the display and driver. It was a fun 
experiment and this is how we learned about Raspberry Pi.” 

Things escalated even further when the brothers made the 
original PiGRRL. Originally an idea from Limor Fried, founder of 
Adafruit and ‘Ladyada’ herself, the idea was to improve upon her 
earlier Game Grrl project but this time use a custom 3D-printed 
enclosure. It was their biggest project to date, so they were 
extremely happy to see that it had such a positive reaction. 

The PiGRRL projects have since become the Brothers’ favourites 
to work on, according to Noe. 

"I think it’s become a classic Raspberry Pi project because it 
looks like an iconic device that offers lots of playtime. People love 
to play games, and being able to build your own gaming console is 
super-rewarding. Every year we create a new version with better 
hardware, and change the form factor to try different designs. So 
many folks have built one and it’s really awesome to see parents 
building them with their kids.” 

What’s in the future for the PiGRRL and the Ruiz Brothers? Well, 
PiGRRL 3 is happening with a “bigger screen and better audio”, and 
should be a much quicker build. Watch this space! 


RRSPBERRY PI 
MONSTER FINDER 


> magpi.cc/2LKXpcA < 

This project caused a little bit a stir at the time, as it 
used some APIs that people possibly shouldn’t have 
had access to. It would tell you if there were any 
monsters in your immediate area, and even display a 
coloured light for how rare the monster was. 


MORE FROM THE 

RUIZ BROTHERS 

Other amazing things you can find 

by Noe and Pedro 
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MAKE YOUR OWN 

PINBALL MACHINE 


This step-by-step guide breaks down the key 
stages of building the Princess Pinball table. 

While your table could be very different, the key 
components and techniques apply to a wide range 
of builds. 

Every pinball table will need a shooter, flippers, 
bumpers, and rubbers. And tips - like using 
adjustable legs to help you get the perfect angle 
on your table - hold true across many different 
build styles. 

Similarly, Martin Kauss’s GPIO connection 
configuration and software to run your table’s 


which we’ll also use later to track the player’s 
score, keyboard, and mouse. 

Open a Terminal window and type: 

sudo apt install python-pygame 
git clone https://github.com/bishoph/ 
pinball.git 
cd pinball 

python pinball_machine.py 

Pressing Q exits the program. Fonts aren’t 
included, so to run the program you’ll need to find 



lights, sensors, sound, and scoring are powerful 
tools for any pinball build. 


your own pinball.ttf and comicfx.ttf TrueType files 
and copy them into /usr/local/share/fonts/ - both 
are freeware and available online. 


q>I Set up the software 

Start with a Raspberry Pi and a clean install 
of Raspbian. You’ll need an internet connection, 
and your life will be easier if you connect a monitor, 


Q2 Vision on 

Setting everything up is much easier if 
you’ve got a monitor connected to your Raspberry 


This eight-channel relay board 
is one of a pair that allows 
Raspberry Pi to trigger the 
table’s moving parts 


A connector strip links 
Raspberry Pi’s GPIO pins 
to all of the electronics on 
and under the playfield 
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Pi, but our pinball table’s Python scripts can also 
make use of an external display. We’ll use this to 
show the player’s current score, the number of 
balls left to play, the table’s high score, and a few 
fun visual effects. 

If you’re feeling really sharp, you could use a 
VESA mount to affix the monitor to a backboard or 
stand attached to the table; or, if you’re working 
with a bed frame like Martin, find space to attach 
it to the one-time head of the bed. 


Q2 Face the music 

You can play sounds through the integrated 
speaker of a monitor or by connecting speakers to 
Raspberry Pi’s 3.5 mm audio output. Sounds are 
defined in the effects.py script, which we installed 
in Step 01. You’ll have to source your own audio 
files - Martin got some from freesfx.co.uk. 

Place them in the /home/pi/pinball/sounds 
directory and edit effects.py accordingly. The 
script triggers sounds when the table is powered 
up, when your ball heads down the shooter alley, 
when it falls out of play by going down the outlane, 
and when it triggers the spinner or pop bumpers. 

Samples in a bank called s2 are triggered as 
random events when the table is idle. 



Q4 Frame and fortune 

Martin Kauss’s pinball table began life as 
a child’s bed, decorated with colourful Disney 
princess imagery, but you could also build your own 
frame out of wood, buy a table base kit, or even 
make one out of K’nex or Meccano. 

The frame measures 143x77cm and for the 
playfield - the surface of the pinball table, where all 
the action happens - Martin used a piece of 230 mm 
thick multiplex board (plywood) with a black finish. 

Beneath the playfield, you’ll need space for your 
wiring and power supplies. 


Test first 

Make sure your 
components 
and connections 
work as 

intended before 
you permanently 
screw them 
into place. 
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Warning! 

High Voltage! 


The pinbaLL machine 
uses a relay to controL 
high voLtage. PLease 
be careful when using 
mains electricity. 


nc More power, Igor! 

This build calls for both a 5 V PSU, which 
handles the lights, and a 36 V one for the coils used 
to power the flippers and bumpers, which have 
comparatively high voltage requirements. 

For example, although the pop bumper’s coil is 
connected to the 36 V supply, its built-in LED light, 
like those elsewhere on the table, is powered by the 
3 V PSU. For ease of connection, a GPIO stacking 
header is mounted on Raspberry Pi’s GPIO. 

From that, GPIO cables run to a connector strip. 
That includes both inputs and outputs, and all 
powered components such as lights and coils are 
wired up via relay boards. The relays are powered 
from Raspberry Pi (via physical pins 2 and 6) 
and the trigger action for each comes from the 
respective output GPIO pin. 

It’s useful to screw a small four-way plug bar to 
the rear or underside of your table, as you’ll need 
separate power supplies for your monitor and 
Raspberry Pi. 


Qg Tilt! Tilt! Tilt! 

Pinball tables can’t be flat, but getting 
the correct angle to ensure that the ball rolls 
towards the bottom at the correct speed can be 
tricky. Adjustable legs mean that you can easily 
set and change the table’s incline. 

In this case, four square wooden battens 
measuring 4.5x4.5x100 cm at the front and 
4.5x4.5x110cm for the rear have been used 
to make front and rear legs. The front pair 
have been made adjustable by using screw-in 
plastic feet which can be raised or lowered, 
allowing for a bit of trial-and-error engineering 
during construction. 


Q7 Plan, sketch & drill 

Once you’ve got your frame and a table 
surface to fit it, it’s time to outline its features. 
Carefully measure, test-place, photograph, and 
draw around the flippers, shooter, slingshot, and 



A Spinner: the spinner itself is 
passive, but a microswitch is 
activated every time the ball 
flips it, triggering scoring, 
sound, and lights 



A You’ll need a healthy 

selection of tools, electronic 
components, and other parts 
for a project like this, as well 
as the space to build it 
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bumpers you want to include. You’ll also want 
to place side-mounted flipper buttons. 

As well as these components, you’ll need to use 
wood and metal strips for your lanes, an outlane 
area to direct the ball back to the shooter alley 
when it’s lost, and the curved upper part of the 
table. Once you’ve marked up and double-checked, 
drill the holes you’ll need to bolt on and wire up 
your components. 


in the playfield using either a router or a drill and 
jigsaw. Mount the switch on a strip of wood, and 
position it beneath the channel so that the switch 
protrudes enough to be triggered by the weight of 
the ball as it passes. 

This build has rollover switch at the end of the 
shooter alley and on all the outlanes that take 


Remember to Leave 


enough space at the 
bottom of the table 
for your electronics 


Remember to leave enough space at the bottom 
of the table for your electronics and Raspberry Pi! 


Qg Assemble the plunger 

The plunger, also known as the ball shooter, 
is the first critical bit of your table to assemble. You 
can buy the whole assembly as a kit, including a 
rod, springs, housing, and mounting components 
such as the external trim plate. 

You’ll want to put it at the left of your table, 
with the knob and external parts protruding 
from the front of your pinball machine. A 
length of wooden batten forms the lane that 
the ball will travel down, and the drain beneath 
the flippers should direct lost balls back to the 
shooter assembly. A high-tension spring holds 
a lane closure flap shut until it’s forced open 
by the velocity of the ball coming through from 
the shooter. 


gg They see me rollin' 

Most of the lanes and structural parts of 
this design are made from wood or aluminium strip 
bent into shape and held in place using wooden 
blocks screwed into the table, all of which makes 
for a pretty forgiving build. But you’ll want your 
Raspberry Pi to be able to tell when the ball passes 
through those lanes. 

For that, you’ll need some rollover 
microswitches from a pinball part supplier, which 
you can fit to the table from below. Cut a channel 
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Go online 
for more 
details 

For extra 
information 
and a maker’s 
blog about the 
Princess Pinball 
table, check out 
Martin Kauss’s 
website at 
magpi.cc/iimYKq 


the ball out of play, plus one at the very end, just 
before the ball re-enters the shooter alley, so the 
table knows when the ball leaves the playfield. 

They’re all connected to Raspberry Pi’s GPIO 
header - via a connector strip - so they can trigger 
events such as lights sound and scoring. 


IQ Flip the finger 

A pinball table’s flippers are its most 
important components. You’ll need a 36 V, 3 A PSU 
to give the flipper coils enough of a kick, and a 
two-channel relay to activate them when triggered 
by Raspberry Pi’s GPIO. 


Because we’re using a Raspberry Pi to control 
everything, we’ll need a modern flipper assembly 
with a normally open (NO) end-of-stroke (EOS) 
switch. The coils are mounted beneath the table’s 
flipper fingers. For each flipper, you’ll need to 
connect a button on the side of the cabinet to one 
GPIO pin, the EOS switch to another, and then 
another two pins - via the relay - to the flipper coil 
units, which actually have two different wire coils 
wrapped around them. 

The first coil, HIGH, provides low resistance 
and makes the flipper finger move hard and fast, 
while the second, HOLD, has high resistance and 
allows you to hold down the flipper buttons to keep 
them upright. 



Pin 

Connector Strip Terminal 

Type 

Description 

Relay Connection 




3 

1 

IN 

Flipper button right 



5 

2 

IN 

Flipper button left 



8 

3 

IN 

Flipper finger EOS right 



10 

4 

IN 

Flipper finger EOS Left 



7 

5 

IN 

Spinner microswitch 



11 

6 

OUT 

Flipper finger right HIGH 

Relay # 1,1 


12 

7 

OUT 

Flipper finger right HOLD 

Relay # 1,2 


13 

8 

OUT 

Flipper finger left HIGH 

Relay # 2,1 


15 

9 

OUT 

Flipper finger Left HOLD 

Relay # 2,2 


16 

10 

IN 

Shooter alley microswitch 



18 

11 

IN 




19 

12 

IN 



^ 

21 

13 

IN 



W k I K I 

22 

14 

IN 

Bumper #1 switch 



23 

15 

IN 

Bumper #2 switch 



2 

16 

IN 

Slingshot switch 



26 

17 

OUT 




29 

18 

OUT 



31 

19 

OUT 



(EP1 

32 

20 

OUT 

Light # 1 , shooter alley 

Relay # 3,1 


33 

21 

OUT 

Light # 2 , slingshots 

Relay # 3,2 

■ V 

35 

22 

OUT 

Light # 3 , bumper 

Relay # 3,3 

^ # * # 1 

36 

23 

OUT 

Light # 4 , bumper 

Relay # 3,4 


37 

24 

IN 

Outlane microswitches, one signal! 

Hyp# It 

38 

25 

IN 

Bumper # 1 , coil 

Relay # 4,1 


k 40 

26 

IN 

Bumper # 2 , coil 

Relay # 4,2 
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The Princess Pinball table 
has proven to be a massive 
hit with Martin’s kids and all 
their friends, complete with 
requests for a future multi¬ 
ball feature 


<13 Add a spinner, connected 
II via screw terminals 

A spinner, or spinning target, is a classic 
pinball table component with its own lane and 
a microswitch that triggers lights and a score 
increment when the player hits it. 

Here, the lane is created using a metal rail 
of aluminium threshold strip. The spinner is 
mounted using some DIY-shop metal brackets 
and bolts, plus star posts and rubber rings from 
a pinball supply firm. 

A straight-wire actuator microswitch is 
connected to the spinner to detect the ball’s 
passage and rack up points and flash lights 
around the table in response. 


11 Into the slingshot 

Slingshot bumpers are the wedge-shaped 
components positioned just above your flippers, 
helping to bounce your ball back to them on its 
journey around the table. 

They’re made up of a set of star posts - brightly 
coloured plastic mounts that a rubber ring can 
fit around and a rubber surround for the ball to 
bounce off. A microswitch sensor detects when the 
ball hits, racking up points, and triggering noises 
and lights. 

A pair of fancy slingshot covers rounds out the 
look, and a lane - made of wood - runs below them 
to provide a route to the flippers. 


12 Add a bumper or two 

Mushroom-shaped pop bumpers are among 
the most iconic elements of a pinball table. They’re 
available in complete kits and most work by 
detecting, via an integrated microswitch, when the 
ball hits their plastic skirt. A coil then pulls down 
the bumper’s rod and ring assembly to kick the 
ball away. 

You can use the bumper’s base to mark out 
where you want to mount it, with the coil mounted 
below the playfield surface. The coils are powered 
by the 36 V PSU and connected to Raspberry Pi via 
the eight-channel relay. 


14 Lights! Action! 

A pinball table is nothing without flashing 
lights. This project uses a 2 m LED light strip 
connected to the 3 V PSU to add some pizzazz to 
the table’s shooter alley and orbit - the upper loop 
of aluminium strip that helps keep the ball rolling 
around the table. 

There are also individual lights in each of two 
bumpers and the slingshot bumpers - a total of 
four GPIO connections on Raspberry Pi. The Python 
script we’re running will activate the lights when 
the ball enters the playfield, hits bumpers, triggers 
the spinner, or passes over rollover switches. The 
lights are also triggered by the script at random 
events if there is no input or action on the table, m 


Fingers 
to yourself 

Don’t touch 
the coils or 
moving parts 
during testing, 
as the rapid 
contraction of 
the solenoid 
can deliver a 
painful pinch. 
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BUILD AN 



Grab some wood, a Raspberry Pi, and some quarters 
and let’s take it back to the 1980s 
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Get Bob's digital 
plans for the arcade ^ 
cabinet online: 


jjMfv 

T 


ifi □ 1 - 

1 

◄ 

X 

M 

Jlilx. 

.E 

1T 

mill- 





Plywood (recommended) for the exterior, MDF for inside 


^ 48" (122 cm) piano hinge 
^ 24" (61cm) soft-close drawer slides 

^ 2 x y 2 " (12.7 mm) overlay face frame concealed hinge (optional) 
^ Magnetic catch (optional) 

^ 3 /4 m (19 mm) T-moulding (optional) - magpi.cc/2ybmvus 
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27" LCD MONITOR 

Old-school arcades used CRT screens 
with high voltage. They are extremely 
dangerous! Modern LCDs work better. 


RASPDERRY PI 

The brains of your entire project. 

We recommend a Raspberry Pi 3 or 4 


COMPUTER SPEAKERS 

Want to hear your games? 
YouTl need speakers. 


magpi.cc/2yUBwhx 


SPEAKER GRILLES 

magpi.CC/ 2 ybuZ 58 

These allow you to hear what's 
playing through the speakers. 


LED ARCADE DUTTONS 

shop.pimoroni.com 

Bash these buttons. 

You can get them from Pimoroni, 


A microcontroller to control 
some of the electronics. 


ARCADE JOYSTICK 

magpi.cc/CeLknL 

Joysticks is the name of a bad eighties 
comedy. These are better. 


magpi.cc/2yDyLFi 

This makes connecting your controls 
to Raspberry Pi as easy as... 


A motion sensor unique 
to this specific build. 


RELAY SHIELD 

Building power control into 
the project? You'll need this 


12V POWER SUPPLY 

Want to light up your cool LED arcade 
buttons? They need power. 


What you need to make - and power - your retro cabinet 


Want to copy Bob's 
build exactly? 
Find his parts list 
on his blog: 


[I 

1 J 1 









£§9 

LED STRIPS 

C ool licrhfQ for \7011r npt \r 



L.uui iigiiio iui yum new 

retro cabinet. 



PIR SENSOR / 



































































If you’ve bought Bob’s design, you 
can start measuring out the side 
panels on the plywood. If you want 
to go with your own design, make 
sure to do some research on the 
shape of the style of arcade cabinets 
you want to go with, and plan it out 
on paper or with CAD software first. 


Begin cutting your panels out with 
your circular saw. Cut as close to the 
corners as you can and use a jigsaw 
or handsaw to finish them off. You 
can use this first side panel to trace 
an outline for the second side panel 
if you wish. 


Now it’s time to measure and 
cut out the main structure of the 
cabinet between the side panels 
using MDF sheets; this includes 
two MDF panels to hold the side 
panels together - albeit with 
a twist. 


In this build, one of the sides can 
open to reveal six hidden drawers. 
This is great for easily accessing 
the electronics inside and also 
using the cabinet for storage. Draw 
reference lines for six of the drawer 
sliders on each side and then 
attach them. 


his old skills 
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Make the top and bottom panels 
out of MDF and attach them using 
screws. Bob also added a bit of 
glue, but reckons it's not entirely 
necessary. Add a bit of scrap wood 
in the open side, just to help keep 
the shape for now. 


As well as drawers, there are 
hidden shelves inside the cabinet. 
These go at the front of the build 
and are short enough to be hidden 
by the front of the side panel. 
Create the basic rectangle/square 
shape of the shelves, and then add 
l-inch (25.4mm) spacers to the 
bottom of the frame before adding 
the bottom shelf on top for added 
strength and support. 


Using the plywood, add a fascia to 
the front of the shelves to bring 
some consistency to the build. 

It will also look a bit nicer than 
the MDF on its own! These can be 
glued in place, but make sure they 
sit flush. 


Create two shelves out of plywood 
and screw them into place. Use 
your tools to make sure they’re 
inserted straight and level. 
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Using clamps, make sure the 
rear cabinet section and front 
bookshelf section are properly 
lined up, and then drive screws 
through the back cabinet section 
to connect the two. 


Use clamps again to line the 
permanent cabinet side up with 
the side of the build. Make sure 
it’s the opposite side to where 
you want the slide-out drawers to 
open. Screw it in on both the back 
cabinet and front shelf section to 
make sure it’s secure. 


For the classic top of the arcade 
cabinet (where we 5 11 house the 
speakers), you need to measure 
around the top of the side panel 
that’s jutting out over and in front 
of the back pieces. Draw some 
guidelines starting from l inch 
(25.4 mm) away from the edge, and 
take into account the width of the 
wood, so you can figure out the 
exact size of the top piece. 


One side of the cabinet is going to 
swing open, which won’t be good 
for the structure of the top piece. 
Create an extra top corner piece to 
help support the top bit, and screw 
it into place.. 


FEATURE 































































ADD 


SOME 


SDPPDRT 


FEATURE 


Use scrap pieces on the fixed side 
to add support to the top piece - 
make sure they're inside the lines 
you measured out in Step n. 


V. 


CDT THE TOP PIECE 

Using all your measurements, 
cut the very top piece for the 
top section. Use your protractor, 
digital or otherwise, to create the 
mitre on the piece so the parts will 
fit together smoothly. Attach it to 
the supports with screws. 


vV 


TOP DACK COVER 


Bob cut a panel for the back 
cover and laid it over the top - 
it's not nailed down, so you can 
quickly access the inside of the 
top sections. 




SPEAKER PANEL 


The bottom panel of the top 
section is where the speakers 
will be attached. Again, using the 
guides you've made, cut out the 
piece and check to see if it fits. 
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Disassemble your speakers and 
draw the outline of where you 
want to place them on the panel. 
Bob used a pencil to draw a couple 
of lines across the outline to find 
their centre, and then cut a big 
hole into it with a drill. Once 
you’ve cut the hole, double-check 
that the speakers line up with it. 


Screw in the speaker panel 
to the top sections. 


The front of the top section is used 
for the marquee, the front art, or 
lights in this case. To make the 
front look a little smarter, Bob 
added another bit of scrap wood 
just inside the hole to create a 
flush surface to add a better fascia 
onto the top section. 


Bob made a simple 
tray-like piece 
that will house the 
controls. It sits on 
top of the shelves at 
the front and does 
not extend beyond 
the dimensions of the 
side panels. 
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FEATURE 


The board where the buttons and 
joystick will live merely covers 
this box. Bob added some blocks 
to the underneath of this board so 
that it can just easily and snugly 
rest on top of the control box for 
easy access. 


The monitor panel needs to be 
angled so you can look down and 
see the screen. Cut and mitre a 
piece of plywood so that it fits in 
the confines of side panel, top 
unit, and control board. Cut a hole 
in the centre to the size of the 
monitor you plan to use. 


Add a little strip of wood, mitred 
to the angle of the monitor panel, 
onto the control board to help 
support the panel. This way you 
don’t have to permanently attach 
the monitor panel to the cabinet. 


Mark the holes for the buttons and 
joystick on the control board and 
cut them out. 


Bob went one 
step further and 
used a CNC 
machine to cut 
holes that gave the 
illusion of a curved 
CRT TV, like in 
classic machines! 


Bob cut the strip into 
several small pieces that 
interlocked, with one piece 
on the control board and 
one on the monitor panel 
for extra stability. 
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Tape down the monitor and 
measure to make sure it’s 
correctly centred. Add two 
blocks to either side and 
then attach a piece over 
them to snugly clamp the 
monitor in place over the 
hole you created for it. 


Remember the drawer runners 
we added to the rear section of 
the cabinet? It’s time to make 
the drawers for them. You 
can make them simply with a 
bottom and four sides if you 
wish, as long as it will fit. Don’t 
add the runners yet, though. 


It’s time to paint the cabinet! Use 
some masking tape to cover up 
anything you’d rather not paint 
(like the runners) and get to it. 

You can use varnish or spray paint 
- Bob used a spray gun and did a 
light bit of sanding between coats. 
You’ll need plenty of room for this! 


Once the paint is dry, you can add 
the buttons and joystick to the 
control board. Affix them in place 
with screws. 


If you want to add the 
T-moulding, you can do that 
now! Cut a small indent into 
the edge of the side panels 
and then use a rubber mallet 
to gently knock it into place. 
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In this build, the marquee is a 
print on something like clear 
acrylic so it can be lit up from 
inside. If you are doing something 
like this, merely glue it into 
the little hole of the top unit. 
Otherwise, attach a final piece 
of plywood to fill the hole. Paint 
a cool little graphic on there, 
though: it will look good. 


Add the speaker 
grilles to the outside 
of the top unit with 
screws, and then 
screw in the speakers 
on the inside. 


Remove one part of 
the runners for the 
drawers and carefully 
attach them to the 
side of the painted 
drawers before 
slotting them in. 


Cut the piano hinge in half 
with a rotary tool, before 
attaching the halves to 
the back board on the 
open side of the cabinet. 
Attach the other side to 
the back edge of the side 
panel so that it can open 
and close. The standard 
build is now complete! 


magpi.cc/2hBcD0K 


Want to do more? 
The original tutorial on 
Bob's website shows 
gou how to add 
motion-activated LEDs 
to the build - great 
for a party piece: 
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new c ibinet to play some g imes 


S tand back and admire your 
work. You've built an arcade 
machine with your own fair 
hands! It's quite the achievement. 
We're not quite done yet, as we 
need to get your Raspberry Pi set 
up and everything connected. In 
comparison, this is the easy part. 


© 




Hll 


I A 


GET RETROPIE 


INITIAL SETUP 


LOAD YOUR ROMS 


Head to the RetroPie website and grab the latest 
image of RetroPie (magpi.cc/25UDXzh). You'll 
then need to install it to an SD card using Etcher 
- you can follow along to our tutorial video to do 
this if it's your first time: magpi.cc/etchervid. 




Put the microSD card in and 
boot up your Raspberry Pi. Go 
through the initial setup just 
to get it going - you'll have to 
do the controller configuration 
again once you install it into 
the cabinet, though. 


It's best to get your ROMs loaded 
onto microSD card before you 
put your Raspberry Pi into the 
arcade cabinet. You can still take 
it out later to add more ROMs, 
as we built it to be accessible. 
Find the info on how to do this 
here: magpi.cc/2hBznjB. 
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CONNECT TO RASPBERRY PI 


The I-PAC can now be connected to Raspberry Pi 
using the USB cable. Load up control configurations 
to set the correct inputs for players one and two. 


TORN IT ON! 


As we’re using light-up buttons, we need to provide 
power for the LEDs in them. You can do this by 
creating a daisy chain of power and ground wires 
that will connect all the lights. This is most neatly 
done by adding them to female plugs that slot onto 
each button’s connectors. You’ll also need individual 
wires for each button and joystick output, and a 
daisy chain of connectors like the power and ground 
ones for the ground connections of the inputs. 


WIRE IT UP 


Connect the individual control wires and input 
ground to the corresponding ports on the I-PAC 
board, and also connect your daisy-chained power 
and ground wires to the buttons/joysticks on one end 
and the screw terminal at the other. 


You’ll need several plugs to power all of this, even 
in its most basic configuration. Raspberry Pi, LEDs 
in the buttons, and monitor will all need power. 
You can just plug them all into the wall, but we 
suggest getting a (surge-protected) power strip 
and plugging all the parts into that. Have a lead 
run out of the back to plug it in and turn the whole 
system on. If you’re doing Bob’s full build, you can 
go a bit further and add a relay switch and more. 


Your Raspberry Pi can now live in the control 
box under the buttons. All you need to do is run 
power for Raspberry Pi and the HDMI cable for 
the monitor through the box - you can do this 
with some well-placed holes behind the monitor 
or through the back of the cabinet. 


POWERING IT ALL 


You’re ready to 
game. Get a soda 
and some Doritos 
to complete 
the experience 
and enjoy your 
own personal 
arcade cabinet. 
Happy gaming! 
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FEATURE 


BARTOP 
ARCADE MACHINE 


magpi. cc/iqOxa Vh 


What makes up the arcade experience? Do you 
have to be in the corner of the room standing 
at a bulky device purely to play games? Bartop 
arcade machines like the Galactic Starcade 
take up less space, but still give the arcade 
experience of playing with a stick. 

This build is also a lot easier to do as you 
don’t have to paint and move a massive 
wooden structure around. You can also just 
plonk it on a table when you want to get it out 
and play some of your favourite games. 


PIK3A 

The cocktail arcade machine is a popular old- 
school variant of the traditional arcade cabinet, 
especially for custom builds. It allows you to 
use the space as a table as well, and two players 
don’t have to crowd around one side of the 
machine to play multiplayer. 

This Pik3a uses the LACK side table from IKEA 
in its construction, giving it a very unique look, 
but there are plenty of other cocktail arcade 
machines you could take inspiration from. 
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Remember. Create. 

K.G. Orphanides on silence, preservation, and the joy of trashgames 


I reviewed the first Raspberry Pi 
Model B, but it took a while for 
me to click with it. As Raspberry 
Pi iterations became more powerful, 
their capabilities intersected with 
the needs of my other projects. 

Preserving the past 

A Raspberry Pi 3 is also key to my 
interest in software preservation 
and emulation. I have a lot of classic 
computers and consoles, but it’s my 
Raspberry Pi-based emulation box that 
I often get out when I want to show 
someone what gaming felt like in the 
1980s and 1990s. It fits in a pocket 
and doesn’t run the risk of a capacitor 
going fizz at a crucial moment. 

But it’s about more than playing 
well-loved games that are otherwise 
unlikely to see a re-release. There are 
whole classes of games and software 
that are at imminent risk of being 
lost to history, and Raspberry Pi 
provides a useful test bed for getting 
many of them running, assessed, 
and documented. 

While there’s no chance that we’ll 
lose Doom, Ultima IV, or Lemmings, 
preservation is less certain for 
novelty screensavers, cheap 


CD-ROM compilations of fascinating 
Windows 95 ‘shovelware’, 3.5-inch 
floppies packed with cheat tools and 
Trainers’ to boost your RPG party’s 
stats, or Java phone games. 

I’m using a Raspberry Pi to find 
working versions of games like 
Rovio’s Darkest Fear survival- 


While I don’t exclusively develop 
on a Raspberry Pi, it’s what got me 
back into programming. It reminded 
me that I could write software for the 
joy of it; for the pleasure of puzzling 
out the logic and structure needed to 
create a meaningful experience in a 
few lines of code. 


□ Write software for the pleasure of puzzling 
out the logic and structure needed to create a 
meaningful experience in a few lines of code □ 


horror/puzzle series - released long 
before Angry Birds was a hit - and 
the elusive feature-phone version 
of Fallout 1, with the intention of 
curating an online archive. 

Coding the future 

But I most love Raspberry Pi for 
the opportunities it holds for new 
developers of all ages. Despite 
numerous unfinished projects and 
false starts, I didn’t release my first 
game - the text adventure ( Eight 
characters, a number, and a happy 
ending’ - until my mid-30s. 


Like home microcomputers of the 
1980s, Raspberry Pi can turn anyone 
into a bedroom programmer, ready to 
join the thrilling indie, art games, and 
wonderfully glitchy trashgames scenes 
born of widespread internet access and 
high-quality, free development tools 
like Twine and PICO-8. EH 



K.G. Orphanides 


K.G. is a writer, deveLoper, and software 
preservation enthusiast with a penchant for 
narrative games, nineties CRPGs, and owLbears. 

@KGOrphanides 
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£10 with FREE 
worldwide delivery 


The only guide you 
need to get started 
with Raspberry Pi 


Inside: 

• Learn how to set up your Raspberry Pi, 
install an operating system, and start using it 

• Follow step-by-step guides to code your 
own animations and games, using both the 

Scratch 3 and Python languages 

• Create amazing projects by connecting 
electronic components to Raspberry Pi’s 

GPIO pins 

Plus much, much more! 


Buy online: magpi.cc/BGbook 


THE OFFICIAL 

Raspberry Pi 

Beginner’s Guide 



















Retro Gaming with Raspberry Pi shows you 
how to set up a Raspberry Pi to play classic games. 

Build your own portable console, full-size arcade 
cabinet, and pinball machine with our step-by-step 
guides. And learn how to program your own games, 
using Python and Pygame Zero. 


■ Set up your Raspberry 
Pi for retro gaming 

■ Emulate classic 
computers and consoles 

■ Learn to program 
retro-style games 

■ Build a portable 
console, arcade cabinet, 
and pinball machine 



































